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はじめに 


本書は、 「 MS - DOS 拡張機能セツト」中の 「 MS - DOS プログラム開発ツールディスク」に収められてい 
るユーティリテイプログラムについて解説したものです。 


本書の目的と構成 

本書の目的は、プログラム開発のためのユーティリティプログラムの使用法について理解していただ 

くことにあります。したがって、本書をお読みになる場合、プログラム開発に関する基礎的な知識を習 

得されていることが前提となります。 

■第1章「プログラム開発ツールの利用にあたって」 

この章は、お求めになった 「 MS - DOS 拡張機能セット」中の 「 MS - DOS プロダラ 
ム開発ツールディスク」のファイル構成、 MASM を用いたプログラム開発の手 
順、各ユーティリティの用途、本書中で用いる表記法などについて説明していま 
す0 

■第2章 「UNK :リンカ」 

LINK は、オブジェクトファイル内のコードとデータを結合するとともに、指 
定されたライブラリを探索して外部參照を解決し、リロケータブル(再配置可能） 
な実行イメージとリロケート（再配置)情報で、実行可能なファイルを作成するも 
のです。この章では、 LINK の起動法、使用可能なスイッチ、マップファイルの 
利用法などについて説明しています。 

■第3章 「MAPSYM :シンボルマップユーティリティ j 

MAPSYM は、 LINK が作成したマップファイルを利用して、 SYMDEB 用の 
シンボルファイルを作成するものです。この章では、その作成方法について説明 
しています。 


⑶ 









はじめに 


■第4章 「SYMDEB :シンボリックデバッガ」 

SYMDEB は、メモリやレジスタの操作、プログラムのトレースや逆アセンブル 
といった一般的なデバッガの機能に加えて、サブルーチンや変数などをシンボル 
(名前）で參照したり、ソースの表示や番号付けをしたりすることのできるシンポ 
リックデバッガです。この章では、 SYMDEB の起動法と、デバッグ中に使用でき 
るすべ ての コマンドについて 説明しています。 

■第5章 「 L 旧：ライブラリマネージャ」 

LIB は、ライブラリファイル中に、オブジェクトファイルを追力1]/登録したり、 
入れ換えたり、削除したりするために用いるユーティリティです。この章では、 
LIB の起動法と、ライブラリ管理のために使用できるコマンドについて説明して 
います。 

■第6章 「MAKE :プログラムメインテナ」 

MAKE は、マクロアセンブラや高級言語によるプログラムの開発工程の保守 
/管理を、単なるバッチ処理より高度に行うためのユーティリティです。この章 
では、メイクファイルの作成法、 MAKE の起動法、動作例などについて説明して 
います。 

■第7章 「 EXE 2 BIN :バイナリファイルコンバータ」 

EXE 2 BIN は、 EXE 形式のプログラムファイルに加工を施して、 COM 形式の 
プログラムファイルを作成したり、絶対アドレス上に置かれるブログラムファイ 
ルを作成したりするのに使うユーテイリテイです。この章では、 EXE 2 BIN の起動 
法と使い方について説明しています。 
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はじめに 


その他のマニュアル 

「 MS - DOS 拡張機能セット」には、本書の他に次のようなマニュアルが添付されています。 

■『 MS-DOS ユーザーズリファレンスマニュアル』 

システムデイスタに 収められている MS - DOS のすベての コマンドに ついて、 
詳しく説明しています。また、 「 MS - DOS 基本機能セット」では扱われていない、 
MS - DOS の高度な機能についても解説しています。 MS - DOS の手弓 I きとして、 
ご利用ください。 

■ 『日本語入カガイド』 

MS - DOS 上で利用可能な日本語入力機能に ついて 解説しています。日本語の入 
力を行う方法と、その他の有用な機能に ついて 詳しく説明し、また、辞書 ファ イ 
ルを保守管理するュー ティ リ ティ （ DICM ) や、ューザーが独自の記号や漢字を作 
成して利用するためのュー ティ リ テイ （ USKCGM ) についても 説明しています。 

■ 『プログラマー ズリファレンスマニュアル Vol . l 』 

■ 『プログラマーズリファレンスマニュアル Vol _2』 

MS - DOS の内部的な技術情報を、詳細に説明しています。 Vol . l では、 MS-DOS 
の提供する各種機能（システムコール、ファンクションコール）や、プログラムお 
よびメモリ管理に関する技術情報を扱っています。 Vol .2 では、周辺装置を制御す 
るデバイスドライバについての情報を扱っています。 MS - DOS の内部機能を使用 
するプログラムを作成される際にご利用ください。 


⑸ 
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プログラム開発ツールの利用にあたって 


本書 「プログラム 開発 ツールマニュアル」 では、 プログラム 開発で利用する各種ユー テイ リ テイの 解説 
を行います。開発言語としては、 マイクロソフ ト マクロ アセンブラ： MASM を想定して記述していま 
す。 


この第1章では、各種ユーティリティの概要と本書で用いている表記法などについて解説します。 


1.1 ファイル構成 


本書で、解説するユーティリティはつぎのとおりです。 


ファイル名 

機 肯 g 

LINK.EXE 

MAPSYM.EXE 

SYMDEB.EXE 

LIB.EXE 

MAKE.EXE 

EXE 2 BIN.EXE 

リンカ 

シンボルマップユーテイリテイ 
シンボリックデバッガ 
ライブラリマネージャ 
プログラムメインテナ 
バイナリファイルコンバータ 










第 1 章プログラム開発ツールの利用にあたって 


1.2 MASM の利用にあたって 

MASM は、8086マイクロプロセッサファミリー用のマクロアセンブリ言語です。対象となるプロセッ 
サは8086、80286、386、486などをはじめとして、8087、80287の数値演算コプロセッサ用のプログラム 
も開発することができます。 

MASM でプログラムを開発するには、マクロアセンブリ言語の文法とソースファイルの書式などの 
予備知識を必要とします。また、8086/80286/386/486マイクロプロセッサファミリーの機能と命令（イン 
ストラクション）セットに関する知識も必要です。 

MASM には、一般的な疑似命令に加えて、型を持ったデータを扱ったり、セグメントを処理するため 
の疑似命令が用意されています。これによって、8086マイクロプロセッサのアーキテクチャを論理的に 
扱うことができます。 MASM の文法、疑似命令（ディ レク ティブ）、オペランド、用例などについては、 
「マクロ アセンブラユーザーズ/リフ ァレンスマニュアル」 を参照してください0 

注意 MASM と「マクロアセンブラユーザーズ/リファレンスマニュアル」は、別売のマクロアセ 

ンブラパッケージに添付されています。 


1.3 ユーティリティの用途 

アセンブリプログラムのソースファイルの作成から、実行可能なプログラムが完成するまでの手順は、 
つぎのような4段階に分けられます。 

1 . ソースファイルの作成 

エディタを使ってアセンブリプログラムのソースファイルを作ります。 

1 

2. ソースファイルのアセンブル 

MASM (マクロアセンブラ）でソースプログラムをアセンブルし、オブジェクトコードを生成します0 

1 

3. オブジェクトコードのリンク 

LINK (リンカ）で、別に開発したプログラムのオブジェクトコードやライブラリファイルのルーチン 
と結合し、実行可能なプログラムを生成します。 

1 

4. プログラムの検証•テスト 

プログラムを実行し、望みの結果が得られなければ 、 SYMDEB (シンボリックデバッガ）でプログラム 
を検証/テストします。 

ユーティリティは、以上のようにしてプログラムを作成する場合の各種作業を支援するもので、名称 
および用途はつぎのとおりです。 
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1.3 ユーティリテイの用途 


• MAKE (プログラムメインテナ） 

プログラムを開発するときは、一般に何度かアセンブル、リンク、テストを繰り返します0 MAKE は、 
このような煩雑な作業を自動化するためのユーティリティです。 

• MAPSYM (シンボルマップユーティリティ） 

LINK の生成したマップフアイルから、 SYMDEB でデバツグするためのシンボルマップファイルを 
作成します。 


- LIB (ライブラリマネージャ） 

リンクの際に用いるライブラリファイルを管理します0ユーザー独自のライブラリファイルを作成し 
たり、ライブラリファイルの内容を変更するときに用います。 

• EXE 2 BIN (バイナリファイルコンバータ） 

完成した EXE 形式のプログラムファイルを、条件が揃えば COM 形式のファイルに変換します。ま 
た、プログラムを絶対アドレスにロードするための変換も行うことができます。 


1.4 本書で用いる表記法 

このマニュアルでは、つぎの ような表記法を用いています。 


表記 

意 味 

CAPS 

大文字のアルファベットは、表記されているとおりに入力する、コマンド 
名、パラメータなどを表します。なお、通常は大文字/小文字はどちらで 
も同様に扱われます。 

< > 

山形カッコは、その位置に入力する項目を表します。たとえば、〈ファイル 
名〉には、ファイルの名前を入力します。 

[] 

角形カッコは、入力を省略できる項目を表します。省略した場合は、シス 
テムであらかじめ設定された（デフオルトの）処理が行われます。 

1 

縦線は、選択項目の区切りを表します。この記号で区切られた項目の中か 
ら、必要なものを選んで入力します。 


繰り返し記号は、必要に応じて、項目を繰り返し入力することを表します。 

(KEY ) 

枠で囲まれた文字は、キーボード上の特定のキーを示します。たとえば、 


「 CTRL '] はコントロールキーを表します。また、1 CTRL 1+1 C ] のような表 
記は、 [ CTRL ] キーを押しながら1 C ] キーを押すことを表します。 


カンマ （，）、 コロン （：）、 セミコロン （；）、 スラッシュ（/)、イコール （=) などの記号類と スペース 
(空白）は、 コマンド などの書式の一部です。表記されている位置に正確に入力してください。 


3 




















第 W 章 
LINK ： U ンカ 



2.1 イントロダクシヨン 

リンカ： LINK は、 MASM または C 、 Pascal のようなコンパイラによって生成されたオブジェクト 
コードから、 MS - DOS で実行可能なファイル ( EXE 形式）を作成します。 

LINK を使用するときは、オブジェクトファイルのファイル名と必要なライブラリファイルを指定し 
ます。 LINK はオブジェクトファイル内のコードとデータを結合し、指定されたライブラリを検索して 
外部参照を解決します。次に LINK は、リロケータブル(再配置可能）な実行イメージとリロケート（再配 
置)情報で、実行可能なファイルを作成します。 

MS - DOS は、 LINK が生成したリロケート情報を使用して、適切なメモリアドレスに実行イメージを 
ロードし実行します。 

LINK は、最大 1 M バイトまでのプログラムを処理することができます。 


2.2 LINK の起動と使い方 

LINK を使うときは、オブジェクトファイルのファイル名、ライブラリファイル名、スイッチなどの 
パラメータを指定します。パラメータの指定方法にはつぎの3種類あります。 

1. コマンドラインでの指定方法 

2. LINK のプロンプトでの指定方法 

3. 応答ファイルでの指定方法 

いずれの方法で LINK を起動した場合でも、1 CTRL [+1 Cl キーを押すことでいつでも処理を中止す 
ることができます。つぎに、それぞれの指定方法で LINK を起動する方法を説明します。 
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第 2 章 LINK : リンカ 


■ コマンドラインでの指定方法 

このコマンドの書式は、つぎのとおりです。 


LINK < オブジェクトファイル名 >[+< オブジェクトファイル名 > …]， 
[< 出カファイル名 >]，[< マップファイル名>]， 

[< ライブラリファイル名>+<ライブラリファイル名 > …] 

[< スイッチ >…] [ ; ] 

くオブジェクトファイル名〉 

リンクしたいオブジェクトファイルのファイル名を指定します。少なくとも1 
つのファイル名を指定しなければなりません。拡張子をつけずに指定した場合、 
、、. OBJ " がついているものとして処理されます。複数のファイルを指定するとき 
は、スペースまたはプラス記号 （+) で区切って指定します。 


<出カファイル名〉 

実行可能ファイルの名前を指定します。省略すると、最初のオブジェクトファ 
イル名の拡張子を 、'. EXE 〃 に変えたファイル名で作成します。また、拡張子なしの 
ファイル名を指定した場合、その名前に自動的に '' EXE " がつけられます。 

<マップファイル名> 

マップ情報を格納するファイルの名前を指定します。拡張子をつけずに指定し 
た場合、 、 X . MAP 〃が自動的につけられます。ファイルの名前を指定せず、/ MAP 、/ 
LINEN UMBERS スイッチも指定しなかった場合、マップファイルは作成されま 
せん。 

くライブラリファイル名〉 

オブジェクトファイルとリンクしたいルーチンの入っているライブラリの名前 
を指定します。拡張子をつけずに指定した場合、 ' LIB " がついているものとして 
処理されます。ライブラリ名を指定しない場合は、セミコロン（：）を入力してく 
ださい。なお、複数のライブラリを指定したり、ライブラリファイルの検索パス 
を設定することもできます。詳しくは 2.2 節中の「ライブラリファイルの検索パス 
の設定」を参照してください。 

<スイッチ> 

LINK の動作を制御するもので、必要に応じて指定します。スイッチはコマン 
ドライン上のどこにでも入れることができます。スイッチの内容については 2.3 
「 LINK のスイツチ」を參照してください。 
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2.2 LINK の起動と使い方 


コマンドラインの任意の場所に、';〃を入力すると、それ以降のファイル名の指 
定が無視され、デフォルトのファイル名が用いられます。 


r- 

Z 

7s 


これはもっとも単純な例です。 LINK は、 、、 test . obj " というオブジェクトファイ 
ルをリンクして、、ヽ test . exe 〃 という実行可能ファイルを作成します。マップファイ 
ルは作成せず、またライブラリの検索も行いません。 

特定のファイル名が指定されない場合でも、つぎの例のようにファイル名を区 
切るカンマ （，） が必要な場合があります。 


例： LINK test ，„ io_lib 

この例では、、ヽ test . obj " というオブジェクトファイルと 、、 io . lib " というライブラ 
リファイルから必要なルーチンをリンクして、 、、 test . exe 〃という実行可能ファイ 
ルを作成します。マップファイルは作成しません。 


例： LINK startup + file , file,file ； 

この例では、、 startup . obj " および、': file . obj " という2つのオブジェクトファイル 
から、 lile . exe 〃という名前の実行可能ファイルを作成します 0 さらに'' file . map 〃 
というマップファイルも作成します。ライブラリは検索しません。 

例： LINK moda + modb + modc + startup / PAUSE ，， abc ，¥ lib¥math 

この例では、、 moda . obj "、、、 modb . obj "、、、 modc . obj " および、、 startup . obj " という4 
つのオブジェクトモジュールがリンクされ、さらに、 x ¥ lib 〃ディレクトリ内の 
、、 math . lib 〃 というライブラリファイルが検索されて必要なルーチンがリンクされ 
ます 0 そして、ヽ、 moda . exe " という名前の実行可能ファイルと、 、、 abc . map " という 
名前のマップファイルが作成されます。なお、/ PAUSE スイッチが指定されてい 
るので、実行可能ファイルを作成する前に処理を一時中断します。 

■ LINK のプロンプトでの指定方法 

コマンド ライ ン で'、 LINK 〃のみを入力すると、 LINK は必要な情報の入力を求 
めるプロンブトを表示します。このプロンブトに応えて、各種のファイルやスイッ 
チを指定します。指定方法は、つぎのとおりです。 

1. LINK とタイプし、リターンキーを押すと、つぎのようなプロンプトが表示 
されます。 


Object Modules [. OBJ ] : 
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このプロンプトには、オブジェクトファイルのファイル名を指定します。省 
略はできません。複数のファイルを指定するときは、スペースまたはプラス 
記号 （+) で区切ります0拡張子についてはコマンドラインで指定する方法と 
まったく同じです。また、指定するオブジェクトファイルが1行で入りきら 
ない場合は、その行の最後にプラス記号 （+) をタイプしてリターンキーを押 
します。こうすると、さらに他のオブジェクトファイルの指定を促すブロン 
ブトが表示されます。 

2. オブジェクトファイルを指定したら、リターンキーを押します。画面には、 
つぎのプロンプトが表示されます。 


Run File [filename.EXE] : 


このプロンプトには、実行可能ファイルのファイル名を指定します。省略し 
た場合や拡張子の扱いはコマンドラインで指定する方法とまったく同じで 
す0 


3. 実行可能ファイルを指定したら、リターンキーを押します。画面には、つぎ 
のプロンプトが表示されます。 

List File[NU し MAP] : 

このプロンプトには、マップファイルのファイル名を指定します。省略した 
場合や拡張子の扱いはコマンドラインで指定する方法とまったく同じです。 

4. 最後にライブラリファイルのファイル名を入力するように、つぎのプロンブ 
卜が表示されます。 

Libraries!].LIB] : 

これもコマンドラインで指定する方法と同じです。なお、1行で入りきらない 
場合は、その行の最後にプラス記号 （+) をタイプしてリターンキーを押しま 
す。こうすると、さらに他のライブラリファイルの指定を促すプロンプトが 
表示されます。 

スイッチは、どの行に入れてもかまいません。また、任意のプロンプトの後に 
vv :〃を入力すると、それ以降のすべての指定を省略したものとして処理します。 

例： Object ModulesC.OBJ] : moda+modb+modc+modee + 

Object ModulesC.OBJ] : startup/PAUSE 
Run FileCmoda.EXE] : 

List FiletNUL.MAP] : abc 
Libraries!!.LIB] : ¥lib¥math 
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2.2 LINK の起動と使い方 


この例は、コマンドラインで 

LINK moda+modb+modc+modee+startup/PAUSE ，， abc ， ¥lib¥math 

と入力したものと同じです。 

■ 応答ファイルでの指定方法 

応答ファイル内に、処理に関係したすべてのファイルの名前を記述し、コマン 
ドラインでその応答ファイルを指定します。この場合は、つぎのように、 v @ 〃をつけ 
て指定します。 

LINK @< 応答ファイル名 > 

応答ファイルには、好きなファイルの名前をつけることができます。このファ 
イルの内容は、つぎのような形で記述します。 

< オブジェクトファイル名 > 

[< 出カファイル名 >] 

[< マップファイル名 >] 

[< ライブラリファイル名 >] 

応答ファイル内の各行は、前項で解説したプロンプトの入力に対応しています。 
指定する名前が1行に入り切らない場合は、その行の最後にブラス記号 （+) を入 
力して、次の行に継続することができます。ファイル名を指定しない場合は、そ 
の行を空にしておきます。 

スイッチは、どの行でも指定可能です。応答ファイル内のどの行でも、〃を 
入れると、それ以降の指定は無視されます。 

応答ファイルに、必要なファイル名が入っていない場合、 LINK は不足してい 
るファイル名の入力を求めるコマンドプロンプトを表示し、応答がキーボードか 
ら入力されるまで待ちます。 


例： moda modb mode startup 
/PAUSE 
abc 

¥lib¥math 


この応答ファイルは、コマンドラインでつぎのように入力した場合と同じです。 


LINK moda modb mode startup/PAUSE ，， abc ， ¥lib¥math 
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■ ライブラリファイルの検索パスの設定 

LINK は、ライブラリファイルを検索するためのパスを環境変数、' LIB 〃に設定 
しておくと、それにしたがってライブラリを検索します。複数のパスを検索する 
場合は、、ヽ；"で区切ります。最大16個までのパスを指定できます。検索パスは、 
ライブラリに明示のパス指定がない場合のみ使用されます。たとえば、 

SET LIB = A : ¥lib ; B : ¥system¥lib 

というコマンドで検索パスを設定した後、 

LINK fiie, , file.map,math+common 

を実行すると、 、' math . lib 〃および、' common . lib 〃 というライブラリを見つけるため 
に、まずカレントディレクトリ、続いてドライブ A 上の、、 ¥ lib 〃、 ドライブ B 上の 
、'¥ system ¥ lib 〃の順にライブラリを検索します。 

検索パスは、コマンドラインで指定することもできます。この場合も、検索パ 
スは明示のパス指定がない場合のみ使用されます。 

例： LINK file”file.map，A : ¥altlib¥math.lib+common+B : +D : ¥lib¥ 

この例では、 v ' math . lib 〃というライブラリを見つけるために、ドライブ A 上の 
、、¥ altlib 〃のみを検索しますが、 、、 common . lib " を見つけるためには、カレントドラ 
イブのカレントディレクトリ、ドライブ B 上のカレントディレクトリ、および最 
後にドライブ D 上の、 x ¥ lib 〃というディレクトリを検索します。 

■ 一時ディスクファイル—— VM.TMP 

LINK は使用可能なメモリを使いつくした場合、カレントディレクトリ内に 
、、 VM . TMP 〃 という一時ファイルを作成します。このファイルを作成したときに 
は、つぎのようなメッセージを表示します。 

VM.TMP has been created. 

Do not change diskette in drive,、d :ク 


このメッセージが表示された後は、処理が終了するまでこのディスクを抜かな 
いでください。処理が終わると、この一時ファイルは自動的に削除されます。 

注意 ユーザー自身のファイルとして " VM.TMP 〃というファイル名を使用し 

ないようにしてください。 UNK が一時ファイルを作成する際に、ユー 
ザー自身のファイルを書き換えてしまいます。 
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2.3 LINK のスイツチ 


2.3 LINK のスイツチ 


LINK のスイッチは、コマンドラインのどこにでも指定できます。スイッチには、つぎのようなもの 
があります。 



スイッチ 

省略形 

機 能 

/PAUSE 

/P 

リンク中の中断 

/MAP 

/M 

パブリックシンボルマップの作成 

/ STACK : く n > 

/ ST ：< n > 

スタックサイズの設定 

/ CPARMAXALLOCXn ) 

/ C ：< n > 

最大割り当てスペースの設定 

/HIGH 

/H 

上位開始アドレスの設定 

/DSALLOCATE 

/DS 

データグループの割り当て 

/LINENUMBERS 

/LI 

行番号の付加 

/NOIGNORECASE 

/NOI 

大文字小文字の区別 

/NODEFAULTLIBRARYSEARCH 

/NOD 

省略時のライブラリの無視 

/NOGROUPASSOCIATION 

/NOG 

プログラム内のグループの無視 

/ OVERLAYINTERRUPT : く n > 

/0: く n > 

オーバレイ割り込みの設定 

/ SEGMENTS : く n > 

/ SE ：< n > 

最大のセグメントの設定 

/DOSSEG 

/DO 

標準のセグメント配置の利用 


以降、各スイッチについて解説しますが、スイッチの表記には省略形を使います。 


■ リンク中の中断 





/p 

/ p スイッチを指定すると、実行可能ファイルを作成する前に、つぎのメツセー 
ジを表示して中断します。 


About to generate . EX 匕 file 

Change diskette in drive く d : >and press < ENTER > 

これによって、実行可能ファイルを書き込む前にディスクを交換することがで 
きます。リターンキーを押すと、処理を再開します。 

注意 VM . TMP ファイルが作成されている場合、このファイルのために使用 

されているディスクを取り外してはいけません。 
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■ パブリックシンボルマップの作成 



/M 


マップファイルのファイル名だけを指定した場合、セグメントの名前/長さ/ 
ロードアドレス、グループの名前/ロードアドレス/エントリエドレスが書き込 
まれます。/ M スイッチを指定した場合、これらの情報に加えて、すべてのパブ 
リックシンボルの情報も書き込みます。 

マツプフアイルについては、2.4「マップファイル」をご覧ください。 


注意 マップファイルを指定しなかった場合でも、/ M スイッチを指定する 

とマップファイルが自動的に作成されます。このファイル名は、先頭の 
オブジェクトファイルと同一のファイル名に ". MAP " という拡張子がつ 
けられたものとなります。 

■ スタックサイズの設定 

/ ST : < n > 

LINK は、通常、オブジェクトファイルにあるスタックセグメントの大きさに 
基づいて、スタックサイズを自動的に計算します。/ ST スイッチを指定した場合、 
計算する代わりにスタックを < n > によって指定されたバイト数にセットしま 
す。 < n > は、1〜65535の範囲内で10進、8進、または16進数で指定できます。 
なお8進数は''0"、16進数は〃で始めなければなりません。 


E 919 


例： /ST : OxFF 


の例では、スタックサイズを 255( FFH ) バイトに設定します。 
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2.3 LINK のスイツチ 


■ 最大割り当てスペースの設定 



/C : < 门 > 


LINK は、通常、プログラムに必要なエリアを最大のパラグラフ数 (1 パラグラ 
フ=16バイト）である65535にセットします。これはすべてのメモリを表している 
ことになるため、 MS - DOS はプログラムをロードしたときに常にこの要求を拒否 
し、存在する最大の連続したブロックのメモリを割り当てることになります。 

/ C スイッチを指定した場合、 MS - DOS はこの< n >で指定された量のスペース 
を割り当てます。これは、メモリ中の他のスペースを他のブログラムが使用でき 
ることを意味します。く n > が必要とされる最小のパラグラフ数より小さい場合、 
LINK はこの指定を無視し、必要とされる最小のパラグラフ数と等しくなるよう 
に割り当てスペースをセットします。プログラムによって必要とされる最小のパ 
ラグラフ数は、常にこのプログラム中のコードおよびデータのパラグラフ数以上 
になります。 

< n > にはパラグラフ数を指定します。 < n > は、1〜65535の範囲内で10進、8 
進、または16進数で指定できます。なお8進数は''0〃、16進数は' ' Ox 〃で始めなけ 
ればなりません。 



■ 上位開始アドレスの設定 



/H 



/ H スイッチを指定した場合、プログラムの開始アドレスは使用可能なメモリ 
のできるだけ高いアドレスにセットされます。このスイッチがない場合、プログ 
ラムの開始アドレスはメモリ中のできるだけ低いアドレスにセットされます0 


■ データグループの割り当て 



/DS 


通常、 LINK は、、 DGROUP 〃というグループ内の最下位バイトにオフセット 
0000 H を割り当てますが、 / DS を指定した場合は、このグループ内の最上位バイ 
卜にオフセット FFFFH を割り当てます。この結果、出力されたデータは、 
DGROUP が入っているメモリセグメント中のできるだけ高いアドレスにロード 
されます。 

/ DS スイッチは、プログラムの開始点より低いアドレスの未使用のメモリを利 
用するために、通常 / H スイッチといっしょに使用されます。 LINK は 、 DGROUP 
内のすべての使用可能なエリアは、このプログラムより低い隣接したアドレスの 
メモリを占有していると想定します。このグループを使用するために、セグメン 
トレジスタは DGROUP の開始アドレスにセツトされなければなりません。 
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■ 行番号の付加 



/ LI スイッチを指定した場合、マップファイルに行番号を付加します。ただし、 
これはオブジェクトファイルに行番号情報が入っていなければなりません 
(MASM や一部の高級言語コンパイラでは、行番号情報を入れることはできませ 
ん）。オブジェクトファイルに行番号情報がない場合、/ LI スイッチは無視されま 
す。 

注意 マップファイルを指定しなかった場合でも、/ U スイッチを指定する 

とマップファイルが自動的に作成されます。このファイル名は先頭の才 
ブジェクトファイルと同一のファイル名、および' MAP 〃 という拡張子を 
つけます。 


■ 大文字小文字の区別 



/NOI 


/NOI スイッチを指定した場合、 LINK はシンボル名の大文字と小文字を区別 
して扱います。通常、 LINK は大文字と小文字を同一のものと見なし処理します。 

/NOI スイッチは、大文字と小文字を区別する高級言語のコンパイラが作成し 
たオブジェクトフアイルに対して使用します。 


■ 省略時のライブラリの無視 



/NOD 



高級言語のコンパイラは、ライブラリと確実にリンクされるように、ライブラ 
リ名をオブジヱクトファイルに付加することができます。/ NOD スイツチを指定 
した場合、このライブラリ名を無視して、 LINK のコマンドラインで指定したラ 
イブラリのみ検索するようになります。 


■ プログラム内のグループの無視 



/NOG 


/NOG スイッチを指定した場合、データやコードの項目にアドレスを割り当て 
るとき、グループの関連を無視するようになります。 

なお、このスイッチの使用は、あまりおすすめできません。 
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■才ーバーレイ割り込みの設定 



/□ : <n> 


/〇スイッチを指定した場合、オーバーレイローディングルーチンの割り込み番 
号が < n > にセットされます。このスイッチによって、デフォルトのオーバーレイ 
割り込み番号 (03 FH ) が無効になります。 

< n > は、〇〜255の範囲内で、10進、8進、または16進数で指定できます。な 
お8進数は％"、16進数は、 ' Ox 〃で始めなければなりません。 


I- 


注意 MS - DOS やデバイスドライバなどの割り込みと競合しない割り込み 

番号を使ってください。 


■ 最大のセグメント数の設定 



/SE : <n> 

/ SE スイッチは、 LINK が処理するプログラムのセグメントの数を設定しま 
す。 LINK は、デフォルトで128までのセグメントを処理しますが、 / SE スイッチ 
でこのセグメント数を設定できます。プログラムが128より多くのセグメントに 
よって構成されている場合に使用します。指定された値より多くのセグメントを 
検出した場合、エラーメッセージを表示して停止します。 

< n > は、1〜1024の範囲内で、10進、8進、または16進数で指定できます。な 
お8進数は％〃、16進数は' ' Ox 〃で始めなければなりません。 


■ 標準のセグメント配置の利用 



/ DO を指定した場合、 MS - DOS のセグメントの順序付けの規約に従って、実行 
可能ファイル内のセグメントを配置します。この規約は、つぎのとおりです。 

1. 、、 CODE 〃というクラス名が付けられたすべてのセグメントは、実行可能ファ 
イルの開始点に置かれる0 

2. 、、 DGROUP " という名前のグループに属さないすべてのセグメントは、 
、、 CODE 〃セグメントの直後に置かれる。 

3. '' DGROUP " に属するセグメントは、このファイルの終わりに置かれる。 
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2.4 マップファイル 

マップファイルには、プログラム中のセグメントの情報とグループの情報、検出される可能性のある 
エラー メッセージが書き込まれます。 

セグメント情報はつぎのような形式です。 


Strat 

Stop 

Length 

Name 

Class 

00000 H 

0172 CH 

0172 DH 

TEXT 

CODE 

01730 H 

01E19H 

006EAH 

DATA 

DATA 


、、 Start 〃および、、 Stop 〃の項には、各セグメントの先頭および最終バイトの20ビットアドレス （16 進)が 
示されています。このアドレスは、0000 0 H からの相対アドレスです0 length " の項にはセグメントの長 
さがバイト単位で、 、、 Name " の項にはセグメントの名前が、 、、 Class " の項にはセグメントのクラス名が示 
されます。 

グループ情報は、つぎのような形式になっています0 


Origin Group 

0000 : 0 IGR0UP 

0173:0 DGR0UP 


この例では、 IGR 0 UP はコード（命令）グループの名前、 DGR 0 UP はデータグループの名前です。 マッ 
プファイルの終わりに、 LINK はプログラムのエントリポイントのアドレスを示します。 

/ M スイッチを指定した場合、上記のマップファイルにパブリックシンボルを付加します。これらのシ 
ンボルは、2回出力され、1回目はアルファべット順、次はロードアドレス順に示されます。 


例： 


ADDRESS 

0000 : 1567 

brk 

0000 : 1696 

chmod 

0000 : 01DB 

chkstk 

0000 : 131c 

clearerr 

0173 : 0035 

fac 

ADDRESS 

0000: 01DB 

chkstk 

0000 : 131C 

clearerr 

0000 :1567 

brk 

0000 :1696 

chmod 

0173 : 0035 

fac 


PUBLICS BY NAME 


PUBLICS BY NAME 
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2.5 LINK の動作方法 


パブリックシンボルのアドレスは、セグメント：オフセットという形式で示されます。これは、ロー 
ドモジュールの開始点(0000 : 000 0) からの相対位置を示しています。 

/H および/ DS スイッチを指定し、リンクしたものが 64K バイト以下であるとき、大きな値のセグメ 
ントアドレスを持つシンボルが示されます0このアドレスは、シンボルがコードおよびデータの実際の 
開始点より低い位置にあることを示しています。 

例： FFFO : 0A20 template 


r- 

Z 

7s 


この例では、 '' template 〃はこのプログラムの開始点より低い位置にあることが示されています。実際 
の template の20ビットアドレスが、0092 0 H であることに注意してください。 


2.5 LINK の動作方法 

SEGMENT や GROUP の MASM の疑似命令によって、 LINK が作成する実行可能ファイルが変化 
します。この節では、 LINK のセグメントの結合方法と参照を解決するための処理方法を説明します。 

■ セグメントの位置合わせ 

SEGMENT 疑似命令のセグメントの位置合わせのタイプ（アラインメント）に 
は BYTE 、 WORD 、 PARA 、 PAGE があります0これらは、バイト、ワード、パ 
ラグラフ、およびページの境界と対応しており、それぞれ、1、2、16、および256 
の倍数のアドレスを表しています0 

LINK はセグメントを検出したとき、この位置合わせのタイプをチェックしま 
す。そこで BYTE タイプのときは直前のセグメントとすきまなく詰め、 WORD 、 
PARA 、 PAGE である場合、最後にコピーされたバイトが該当する境界で終了し 
ているかチヱックし、そうでなレゝ場合には境界までをゼロで埋めます。 


■ フレーム 番号 

LINK は、プログラム中の各セグメントごとに、開始アドレスを計算します。 
この開始アドレスは、セグメントの位置合わせ、および実行可能ファイルにすで 
にコピーされたセグメントの大きさに基づいて行われます。このアドレスは、才 
フセットおよび、、標準フレーム番号〃によって構成されます。標準フレーム番号は、 
1バイト以上のバイトのセグメントが入っているメモリ中の先頭のパラグラフの 
アドレスを指します。フレーム番号は、常に16の倍数（パラグラフのアドレス）で 
す。オフセットは、このパラグラフの開始点からセグメント内の先頭バイトまで 
のバイト数です。 BYTE および WORD の位置合わせの場合、オフセットはゼロ 
でない場合がありますが、 PARA および PAGE の位置合わせの場合は常にゼロ 
です。 

セグメントをリンクするとき、このセグメントのフレーム番号を LINK によっ 
て作成されたマップファイルから取得することができます0フレーム番号は、こ 
のセグメントのために指定された、'開始〃アドレスの16進の先頭の5桁です。 
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■ セグメントの順序 

LINK は、オブジェクトファイル内でセグメントを検出した順序で、実行可能 
ファイルを作成します。この順序は、 LINK が同一のクラス名が付けられた複数 
のセグメントを検出しないかぎり、このプログラムを通して維持されます。同一 
のクラス名が付けられたセグメントは同一のクラスに属し、連結したブロックと 
して実行可能ファイルにコピーされます0 
つぎの プログラム例では、 、、D AT AX" および、、 DAT AZ 〃というセグメントは1 
クラスを形成します。両方のセグメントは、実行可能ファイルで、、 TEXT 〃セグメ 
ントの前に作成されます。 


DATAX 

segment 

’DATA ， 

DATAX 

ends 


TEXT 

segment 

’CODE’ 

TEXT 

ends 


DATAZ 

segment 

’DATA ， 

DATAZ 

ends 



すべてのセグメントは、何らかのクラスに属します。クラス名が明示で定義さ 
れていないセグメントにはノ null" クラス名が付けられ、 null クラス名が付けられ 
た他のセグメントと一緒に連続したブロックとして処理されます。 

LINK では、1クラス内のセグメント数や大きさは無制限です。1クラス内のす 
ベてのセグメントを総計した大きさが、 64K バイト以上であっても構いません。 

■セグメントの結合 

LINK は、結合タイプ（コンバイン）によって、同一のセグメント名を共有する 
複数のセグメントを単一の大規模なセグメントに結合すべきかどうかを決定しま 
す。結合タイプには、 public、stack、memory、common、private があります0 

結合タイプが public である場合、 LINK は同一の名前で同一のクラスに属する 
すべてのセグメントを結合します。セグメントを結合するとき、これらのセグメ 
ントが連続しており、これらのセグメント内のすべてのアドレスが同一のフレー 
ムのアドレスからのオフセツトを使用してアクセス可能になるようにします。こ 
の結果、このセグメントがソースファイル内で全体として定義されている場合と 
同一のものが生成されます。 

LINK は、それぞれのセグメントの位置合わせのタイプを保存します。これは、 
セグメントが大規模なセグメントに属していても、セグメント内のコードおよび 
データはもとの位置合わせを保存するという意味です。結合されたセグメントが 
64K バイトより大きい場合、エラーメッセージを表示します。 

セグメントのタイプが stack または memory である場合、 LINK は public セ 
グメントと同様の結合操作を行います。1つ違うのは、 stack の場合、最初のスタッ 
クポインタ値を実行可能ファイルにコピーするこということです。このスタック 
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ポインタ値は、検出された先頭のスタックセグメント（または結合されたスタック 
セグメント）の終わりまでのオフセットです0 

セグメントのタイプが common の場合、同一の名前が付けられ、同一のクラス 
に属するすベてのセグメントと結合します。 common セグメントを結合すると 
き、各セグメントの開始点を同一のアドレスにロードし、オーバラップしたセダ 
メントを作成します。この結果、結合された最大のセグメントと同一の大きさの 
単一のセグメントが生成されます。 

ソースファイル内で、セグメントのために明示の結合タイプが定義されていな 
い場合、このセグメントのタイプは private になります。 private セグメントは結 
合しません。 


n 

z 

7s 


■ グループ 

グループによって、連続しておらず、同一のクラスに属していないセグメント 
は、同一のフレームアドレスからの相対アドレスでアドレス指定することができ 
ます。 

LINK は、グループを検出したとき、このグループ内の項目に対するメモリ参 
照が、同一のフレームアドレスからの相対アドレスになるように調整します。 

グループ内のセグメントは、連続している必要はなく、同一のクラスに属する 
必要もなく、結合タイプが同一である必要もありません。グループ内のすべての 
セグメントが、 64K バイト内に収まることだけが必要とされます。 

グループは、セグメントがロードされる順序に影響を及ぼしません。クラス名 
を使用せず、オブジェクトファイルを正しい順序で入力しなかった場合、セグメ 
ントが連続しているという保障はありません。実際に LINK は、同一の 64K バイ 
トメモリ中にこのグループに属さないセグメントをロードする可能性がありま 
す。 LINK は、グループ内のすべてのセグメントが 64K バイト以内かどうか 
チェックしないので、これが満たされない場合、フィックスアップオーバフロー 
エラーを検出する可能性があります。 


■ 參照の解決 

プログラム中の各セグメントの開始アドレスとすべてのセグメントの組み合わ 
せおよびグループを確立すると、 LINK は、ラベルおよび変数の参照を解決しま 
す。参照を解決するために、 LINK は該当するオフセットおよびセグメントのア 
ドレスを計算し、アセンブラによって生成された一時的な値を新規の値で置き換 
えます。 

LINK は、以下の4つの異なった参照を解決します。 


• Short 


• Near Self-Relative 

• Near Segment-Relative 


• Long 
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計算する値の大きさは、参照のタイプによります。 LINK は、參照でエラーを 
検出した場合、メッセージを表示します。プログラムが16ビットのオフセットを 
使用して、異なったフレームアドレスを持つセグメント内の命令にアクセスしよ 
うとした場合などに、このエラーが発生する可能性があります。 

short 参照は、参照点から128バイト以内のところになければなりません。 
LINK はこの参照のために、符号付の8ビットの数を計算します。 

near self-relative 參照は、同一のセグメントやグループからの相対アドレスに 
あるデータにアクセスするときに行われます。 LINK は、この參照のために、16 
ビットオフセットを計算します。 

near segment-relative 参照は、指定されたセグメントやグループ内のデータ、 
または指定されたセグメントレジスタからの相対アドレスにあるデータにアクセ 
スするときに行われます。 LINK は、この參照のために、16ビットオフセットを 
計算します。 

long 参照は、 CALL 命令が他のセグメントまたはグルーブ内の命令にアクセス 
するときに行われます0 LINK は、この参照のために、16ビツトフレームアドレ 
スおよび16ビットオフセットを計算します。 

■ ローデイングの順序の制御 

空のセグメント定義が示されているダミープログラムを作成し、アセンブルす 
ることでセグメントのローデインダの順序を制御することができます。 LINK を 
実行するときには、このファイルを先頭のオブジェクトファイルとして指定しま 
す。 

つぎのダミープログラムは、 CODE、DATA、STACK、CONST、MEMORY 
という名前のセグメントによって構成されるプログラム中のセグメントのロー 
ディングの順序を定義します。 


CODE 

segment 

’CODE’ 

CODE 

ends 


CONST 

segment 

’CONST’ 

CONST 

ends 


DATA 

segment 

’DATA ， 

DATA 

ends 


STACK 

segment 

stack ’STACK’ 

STACK 

ends 


MEMORY 

segment 

’MEMORY’ 

MEMORY 

ends 



このダミープログラムには、ブログラム中で使用すべきすべてのクラスのため 
の定義が入っていなければなりません。入っていない場合、ユーザーの希望する 
順序と一致しない場合があります。 
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注意 C 、 Pascal などの高級言語のプログラムと一緒に、ダミープログラム 

を使用しないでください。このような言語は、それ自身の口ーディング 
順序を定義するからです。 

ダミープログラムの終わりに空の MEMORY セグメントを置くと、 
MEMORY セグメントをプログラム中の最終セグメントとしてロードす 
るように LINK に強制することができます。空のセグメントは、つぎのよ 
うに指定します。 


r- 


くセグメント名 > segment memory ’< クラス名 〉’ 
< セグメント名 > ends 


2.6 メッセージ 

リンカ： LINK の表示するメッセージをアルファべット順に解説します。 


About to generate 上 XE file 

Change diskette in drive <d : > and press < ENTER > 

EXE ファイルを作成する処理を中断しています 0 EXE ファイルを収めるディスクをドライブく d : > 
にセット（交換）して、リターンキーを押してください。これは、 /P スイッチを指定したときに表示される 
メッセージです。 

Ambiguous switch error : ” x” 

スイッチ名を省略しすぎて、一意に確定できません。スイッチの最小の省略形を確認してください。 
たとえば、つぎのようなスイッチの指定をすると、このメッセージが表示され、 LINK は処理を中止し 


ます。 


A>LINK /N main ; 


Array element size mismatch 

コモンなアレイ領域が、 2 ケ所以上で、異なるサイズのエレメント（文字型と実数型など）で宣言されて 
います（現バージョンの MASM では、コモンなアレイはサポートされていません）〇 


Attempt to put segment < name > in more than one group in file 
< filename > 

く filename〉 中のセグメントく name〉 は、 2 つのグルーブで重複して定義されています。ソースファ 
イルを修正して、オブジェクトファイルを作り直してください。 

Attempt to access data outside segment bounds 

セグメント外のデータをアクセスしようとしました。オブジェクトのソースを修正してください。 
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Bad value tor cparMaxAlloc 

/C : <n> スイッチで指定した数値が 1 〜65535の範囲外です。 

Cannot find library : < filename 〉 .lib. Enter new file spec : 

指定されたライブラリファイルく filename>.lib が見つかりません0ドライブ名、パス名、ファイル名 
を確認して、正しいファイル名を入力してください。 


Cannot rind file 

ファイルが見つかりません0正しいファイル名を入力してください。 


Cannot nest response files 

応答ファイル中に、さらに応答ファイル名が含まれています。応答ファイルはネスト（入れ子）にでき 
ません。応答ファイルを修正してください。 


Cannot open list file 

ディスクまたはディレクトリが一杯で、マップファイルを作成できません0ディスクまたはディレク 
トリの空きスペースを作ってください。 


Cannot open response file 

応答フアイルをオープンできません。フアイル名を間違って入力していないかどうか確認してくださ 


Cannot open run file 

ディスクまたはディレクトリが一杯で、実行可能ファイルを作成できません。ディスクまたはディレ 
クトリの空きスペースを作ってください。 


Cannot open temporary file 

ディスクまはたディレクトリが一杯で、一時作業ファイル （VM.TMP) を作成できません。ディスクま 
たはデイレクトリの空きスペースを作ってください。 


Cannot reopen list file 

LINK を起動したディスクが交換されたために、マップファイルを再オーブンできませんでした。 
LINK を再起動してください。 


Common area longer than 65535 bytes 

プログラムが、 64K バイト以上のコモン変数を持っています。 


Data record too large 

オブジェクトモジュール中の LEDATA レコードに、1024バイト以上のデータが入っています0 


22 


2.6 メッセージ 


Dup record too large 

オブジェクトモジュール中の LIDATA レコードに、 512 バイト以上のデータが入っています0これは 
構造定義が複雑すぎたり、 DUP ステートメントのネストが深すぎる（例 ： ARRAY db 10 dup(lldup 
(12 dup (13 dup (… ）））） ことが原因と考えられます。ソースファイルを修正してください。 

” く filename〉’’is NOT a valid library 

指定したライブラリファイルく: filename 〉 に問題があります。 


厂 

Z 


Fixup overflow near く num>in segment < name > in < filename > (name)offset 
< num> 

このメッセージが出力される原因としては、つぎのような状況が考えられます。 

1) 1グループが 64 K バイト以上ある。 

2) プログラム中に、セグメントにまたがる short ジャンプ/コールが含まれている。 

3) リンクするライブラリ中のルーチンと、同一のデータ項目名が使われている0 

4) セグメントの本体中で、 EXTRN が用いられている。この例をつぎに示す。 


CODE 

segment public 

extrn 

main far 

start 

proc far 

call 

main 

ret 


start 

endp 

CODE 

ends 


つぎのプログラムは前例を修正したもの。 


extrn 

main : far 

CODE 

segment public 'code' 

start 

proc far 

call 

main 

ret 


start 

endp 

CODE 

ends 


Incorrect DOS version 

DOS のバージョンが違います。動作可能な DOS のバージョンで起動してください0 

Insufficient stack space 

メモリ不足で、 LINK を実行できません。 
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Interrupt number exceeds 255 

/〇 : < n > スイッチで、指定された数値が〇〜 255 以外です。 

Invalid numeric switch specification 

スイッチに、無効なパラメータが指定されています。数値を指定するべきところで文字を指定してい 
る （0 と0の間違い）、なども原因として考えられます。 


Invalid object module 

オブジェクトモジュールに問題があります。アセンブルまたはコンパイルしなおしてください0 

NEAR/HUGE conflict 

コモン変数の near と huge の定義が重複しています（現バージョンの MASM では、コモン変数はサ 
ポートされていません）。 


Nested left parentheses 
Nested right parentheses 

オーバーレイを指定する、 LINK のコマンドラインに、文法的な誤りがあります0 

No object modules specined 

オブジェクトフアイルが指定されていません。 


Object not found 

オブジェクトが見つかりません。ファイル中のオブジェクトモジュールを確認してください0 


Out or space on list file 

マップファイルを書き出し中、ディスクが一杯になって入りません。ディスクの空きスペースをふや 
して、 LINK を再起動してください。 


Out of space on run file 

.EXE (実行可能）ファイルを書き出し中、ディスクが一杯になって入りません。ディスクの空きスペー 
スをふやして、 LINK を再起動してください。 


Please replace original diskette in drive く d : > and press < ENTER > 

LINK を起動した（オリジナル）ディスクをドライブく d : >にセットして、リターンキーを押してく 
ださい。これは / P スイッチを使用したときに表示されるメッセージで、 EXE ファイルを書き出し終わる 
と出力されます。 


Program entry point at く nnnn : nnnn> 

プログラムのエントリポイントのアドレスを、、、セグメント：オフセツト"の形式で表示します。 
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Relocation table overfolw 

16384バイトを超す long コール/ジャンプ/ポインタが使われています。 long 参照を short 參照に換え 
て再処理してください。 


Segment limit set too high 

/SE : < n > スイッチで指定した数値が大きすぎます。 

Segment limit too high 

/SE : く n > スイッチで指定した値（または初期設定値： 128) で、アロケートテーブルを作るには、メモ 
リが不足しています。値を小さくするか、メモリのフリーエリアを広げてください。 


Segment size exceeds 64K 

セグメントサイズの制限、 64 K バイトを超えています。たとえば、スモールメモリモデルでありなが 
ら 64 K バイト以上のコード、コンパクトメモリモデルでありながら 64 K バイト以上のデータを持って 
いるなどが相当します。メモリモデルを変更して、コンパイルとリンク処理を行ってください0 


Stack size exceeds 65536 bytes 

/ STACK スイッチで指定した値が、65536バイトを超えています。 


Symbol already denned 

シンボル名はすでに定義されています0名前を変更して再処理してください0 


Symbol denned more than once 

シンボル名が多重定義されています。名前を変更して再処理してください。 


Symbol table overflow 

プログラムが、 256 K バイト以上のシンボル情報 （ public 、 extrn 、 segment 、 group 、 class 、 file など) 
を含んでいます。セグメントやモジュールの結合などを行って、オブジェクトファイルを作り直してく 
ださい。 

Terminated by user 

I CTRL 」+ f ^] キー入力によって、リンク処理が中止されました。 


Too many external symbols in one module 

オブジェクトモジュール中の外部シンポルが多過ぎます。モジュールを分割するなどしてください。 


Too many group-, segment-, and class-names in one moaule 

グループ名、セグメント名、クラス名が多過ぎます。数を減らしてオブジェクトファイルを作り直し 
てください。 

Too many groups 

プログラム中で10個以上のグループを定義しています。 
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Too many GRPDEi-s in one module 

1 モジュール中に 10 個以上の GRPDEF があります。数を減らすか、モジュールを分割してください。 

Too many libraries 

17個以上のライブラリファイルを指定してます。16個以下にしてください。 


Too many overlays 

64個以上のオーバーレイを定義しています0数を減らしてください0 


Too many segments 

ブログラム中のセグメントが多すぎます。/ SEGMEN 丁スイツチのパラメータを適当な数値にふやし 
て、再びリンク処理を行ってください。 


Too many segments in one moaule 

オブジェクトモジュールに、256個以上のセグメントが含まれています。オブジェクトを分割するか、 
セグメントを連結して数を減らしてください。 


Too many TYPDEFs 

オブジェクトモジュール中の TYPDEF レコードが多過ぎます。このレコードは、コンパイラがコモン 
変数の領域のために生成したものです（現バージョンの MASM は、コモン変数をサポートしていませ 
ん ） 〇 


Unexpected end-of-file on library 

ライブラリを収めたディスクが、外された可能性が高いと考えられます。ディスクを確認してくださ 

い0 


Unexpected end-of-file on scratcn file VM.TMP 

VM . TMP ファイルの作られていたディスクが、外された可能性が高いと考えられます。ディスクを確 
認して、 LINK を再起動してください。 


Unmatched left parenthesis 

オーバーレイを指定する LINK のコマンドラインに、文法エラーがあります。 

Unmatched right parenthesis 

オーバーレイを指定する LINK のコマンドラインに、文法エラーがあります。 

Unrecognized switch error : ’’< switch >” 

スイッチとして、無効な文字が指定されています。 

VM.TMP is an illegal file name and has been ignored 

オブジェクトファイル名に、' VM . TMP 〃が使われています。ファイル名を変更してください0 
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2.6 メッセージ 


Warning : no stack segment 

プログラムは、スタックスペースセグメントを割り当てるステートメントを含んでいません。 

Warning : too many public symbols 

パブリックシンボルのソート（並べ換え）マップを要求しましたが、シンボル数が多過ぎて、ソートで 
きませんでした。 LINK は、ソートしていないパブリックシンボルのマップを作成しました。 
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第章 


MAPSYM :シンボルマップユーテイリテイ 


3.1 イントロダクシヨン 

シンボルマップユーティリティ： MAPSYM は LINK が作成したマップフアイルを利用して、 
SYMDEB 用のシンボルファイルを作成します0 


3.2 シンボルファイルの作成 

SYMDEB 用のシンボルファイルを作るために、まず LINK でマップファイルを作成します0このと 
き、 LINK のスイッチとして / M (/ MAP ) と/ LK / LINENUMBER ) の2つを指定して、マップファイル 
を作成します（詳しくは、第2章 「LINK :リンカ」を参照してください）。ここで作成されたマップファイ 
ルから MAPSYM でシンボルファイルを作成します0 

MAPSYM コマンドの書式はつぎのとおりです。 

MAPSYM [-U/L] くファイル名 > 

<ファイル名〉には、 LINK で作成されたマップファイル(拡張子は. MAP ) の名前を指定します。ドラ 
イブ名やパス名を付けて指定することもできます。拡張子を省略した場合、 ' MAP 〃と解釈されます。作 
成されたシンボルファイルの拡張子は、'. SYM " になります。このシンボルファイルは、カレントデイレク 
トリに作成されます。 

スイッチの - L と / L は同じもので、プログラムに定義されたグループ名、プログラムの開始および行番 
号の有無などの変換に関する情報を表示します。 

たとえば、マップファイル、、 file . map 〃からシンボルファイル、、 file . sym " を作成する場合は、つぎのよう 
に入力します。 

MAPSYM file-map 


MAT3SYM 
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3.3 メッセージ 

MAPSYM が表示するメッセージをアルファべット順に解説します。 

Can’t create : < filename > 

カレントのドライブまたはディレクトリが一杯です。空きスペースを作ってください。 

Can’t open MAP file : < filename > 

指定されたマップファイルがありません。ファイル名を確認してください。 

mapsym : out of memory 

処理に必要なメモリが足りません。 

mapsym : segment table(,n)exceeded. 

マップファイル中のセグメント数が1024個を超えています。 （ n ) はマップファイル中の総セグメント 
数を示しています。 

No entry point, assume 0000 : 0100 

プログラムのエントリポイントがないため、0000 : 0100番地を想定します。 

No public symbols 
Re-link file with /m switch! 

LINK で/ M スイッチを指定しなかったために、パブリックシンボル名がありません。もう一度リンク 
しなおしてください。 

Program entry point at < segment> : < offset> 

プログラムのエントリポイントのアドレスを表示します。 

Unexpected eof reading : < filename > 

マップファイルが正しく生成されていないので、もう一度リンクしなおしてください。 

usage : MAPSYM [/I] maplist 

コマンドラインに誤りがあります。正しく指定してください。 

Write fail on : < filename > 

シンボルフアイルを作成中にエラーが発生しました。 
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SYMDEB :シンボリックデバッガ 


4.1 イントロダクシヨン 

シンボリックデバッガ： SYMDEB は、メモリやレジスタの操作、ブログラムのトレースや逆アセンブ 
ルといった一般的なデバッガの機能に加えて、サブルーチンや変数などをシンボル(名前）で参照するこ 
とのできるシンボリックデバッガです。また、 SYMDEB の強力な機能として、ソースの表示と番号付け 
があります。この機能によって、高級言語のデバッグが機械語のレベルだけでなく、ソースのレベルで 
も行えます。 

このような高度なデバッグを行うためには、シンボルファイルを作成しておく必要があります。シン 
ボルファイルの作成については、第3章 「MAPSYM :シンボルマップユーテイリテイ」を参照してくだ 
さい。 


4.2 SYMDEB の起動 

SYMDEB を起動すると、 SYMDEB のプロンプト ㈠ が表示され、 SYMDEB のコマンドを入力でき 
る状態になります。 SYMDEB は、つぎのような書式で起動します。 

SYMDEB [ くシンボルファイル名 >] [ く実行ファイル名 >][< 引数リスト >] 


<シンボルファイル名> 

MAPSYM で作成されたシンボルファイル（拡張子、、. SYM 〃） のファイル名を指定します0複数のファ 
イルを指定することもでき、この場合、次の<実行ファイル名〉の前にすベてのシンボルフアイルを指 
定します。 


<実行ファイル名> 

デバッグする実行可能フアイルのフアイル名を指定します。 


く引数リスト〉 

<実行ファイル〉に与える引数を記述します。 

例： SYMDEB file.com 
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この例のように実行ファイルのみ指定した場合、 SYMDEB は、使用可能なメモリの最下位セグメント 
の先頭から 100 H (256) バイトのプログラム用のヘッダを作成し、 100 H 番地以降にファイルをロードし 
ます。ただし、 EXE 形式のファイルの場合は、ファイルのヘッダ部分で定義されたアドレスにロードし 
ます。 

さらに、ファイルの大きさ（バイト単位）を BX : CX レジスタにセットし、セグメントと他のレジスタ 
をファイルのヘッダ部分で定義された個々の値にセットします。 

例： SYMDEB file.sym file.exe 

この例では、、、: file . sym " からシンボル情報を読み込みます。次に、プログラム用のヘッダを作成した後 
に、 、、 file . exe " をロードします 0 

例： symdeb file.sym file.exe test.dat/m/b 

この例では、 、、 test . dat / m / b " をプログラム用のヘッダにコピーし、それから N ' file . exe 〃 をロードします 0 
ヽ\ test . dat / m / b 〃は' 1 ' file . exe " の引数になります 0 

すべてのパラメータを省略して、単に、' SYMDEB " と入力して起動することもできます。起動後、 
SYMDEB のプロンプトが表示され、 SYMDEB のコマンドが入力できます。 

例： A>symdeb 

Microsoft Symbolic Debug Utility 
Version 3.10 

(C)Copyright Microsoft Corp 1984，1985 
Processor is [80286] 


4.3 コントロールキーの使用 


SYMDEB を実行中、誤りの修正やコマンドの停止には、 MS - DOS ユーザーズリファレンスマニュア 
ルで述べられているコントロールキャラクタやテンプレート機能を用いることができます。 

SYMDEB は 丨 CTRLl+l C ] キーを押すと、実行中のコマンドを停止してプロンプトを表示します。 
〔 CTRL]+[S j キーを押すと、 SYMDEB はコマンド出力を一時的に中断します。ただし 、 Redirection 
コマンドで、、 AUX 〃を利用しているときには、1 CTRL |+1 ( T | キーによる停止と | CTRL 丨 +rS |キーに 
よる中断は無効ですので注意してください。 

また、 Go コマンドでプログラムを実行中、 [] CTRLI +〔 CI キーで停止することもできますが、これは 
プログラムが入出力の処理をしているときに限られます。 
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4.4 コマンドとパラメータの表記 


4.4 コマンドとパラメータの表記 

SYMDEB のコマンドをつぎの表に示します0 


コマンド名 書式 機 能 


Assemble 

A 

Breakpoint Set 

BP 

Breakpoint Clear 

BC 

Breakpoint Disable 

BD 

Breakpoint Enable 

BE 

Breakpoint List 

BL 

Comment 

ホ 

Compare 

C 

Display 

? 

Dump Ascii 

DA 

Dump Bytes 

DB 

Dump Words 

DW 

Dump Doublewords 

DD 

Dump Short Reals 

DS 

Dump Long Reals 

DL 

Dump Ten-byte Reals 

DT 

Dump 

D 

Enter Ascii 

EA 

Enter Bytes 

EB 

Enter Words 

EW 

Enter Doublewords 

ED 

Enter Short Reals 

ES 

Enter Long Reals 

EL 

Enter Ten-byte Reals 

ET 

Enter 

E 

Examine Symbol Map 

X 

Fill 

F 

Go 

G 

Help 

? 

Hex 

H 

Input 

1 

Load 

し 

Move 

M 

Name 

N 

Open Map 

XO 

Output 

0 

P Trace 

p 

Quit 

Q 

Redirection 

< 

> 

Register 

R 

Search 

S 

Set Source Mode 

S 

Shell Escape 

! 

Source Line 


Stack Trace 

K 


アセンブル 

ブレーク ボイントの設定 
ブレーク ポイントの解除 
ブレーク ボイントの禁止 
ブレーク ポイントの許可 
ブレーク ポイントのリスト 
コメントの表示 
比較 

式の値の表示 
ASCII ダンプ 
バイトダンプ 
ワードダンプ 
ダブルワードダンプ 
ショート実数のダンプ 
ロング実数のダンプ 
10バイト実数のダンプ 
ダンプ 

ASCII コードの入力 
バイトデータの入力 
ワードデータの入力 
ダブルワードデータの入力 
ショート実数の入力 
ロング実数の入力 
10バイト実数の入力 
データの入力 
シンボル情報の表示 

フイノレ 

実行 

コマンドー覧の表示 
16進計算 
ポ^ー ト入力 

ロード 

移動 

名前のセット 

シンボルマップ、セグメントの設定 
ポート出力 

割り込みに対応したトレース 

SYMDEB の終了 

入力の切り換え 

出力の切り換え 

入力と出力の切り換え 

レジスタの表示と設定 

サーチ 

ソース形式のセット 
MS-DOS コマンドの実行 
現在のソースラインの表示 
スタックフ レームの 表示 


S 

〇 

m 

U) 
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Symbol Set 

Z 

Trace 

T 

Unassemble 

U 

View 

V 

Write 

w 


シンボリツクアドレスに値をセツト 
トレース 
逆アセンブル 
ソース ライ ンの 表示 
書き込み 


コマンドの後には、パラメータを必要とするものもあります。複数のパラメータを指定する場合は、 
カンマ （，） またはスペースでパラメータを区切ります。コマンド名とパラメータについては、大文字と小 
文字の区別は行われません。 

以後の項では、コマンドのパラメータについて詳しく説明します。 

■ シンボル 

シンボルは、レジスタ、絶対値、セグメントアドレス、セグメントのオフセツ 
卜を表す名前です。シンボルは、必ず文字または記号（_、？、@、 $) で始まります。 

レジスタを表すシンボル（レジスタ名）は常に使用可能ですが、他のシンボルは 
シンボルファイルがロードされている場合にのみ使用することができます。レジ 
スタ名は、他のシンボルに優先しますから、レジスタ名と同じ名前のシンボルは 
無視されます。 

例： AX 
main 
DGROUP 
IP 


■数値 

SYMDEB では、2、8、10、16進数を用いることができ、添え字でその基数を 
表します。添え字は、つぎのとおりです。 


添え字 

タイプ 

使用できる数字 

Y 

2 進数 

01 

0 ,Q 

8 進数 

01234567 

T 

10 進数 

0123456789 

H 

16進数 

0123456789 ABCDEF 


デフォルトは16進数なので、添え字を省略すると16進数と見なされます。 
数には、数字をいくつでも入れることができますが、 SYMDEB では、数が 
65535より大きい場合は、先頭の数字を切ります。また、先頭にゼロがあっても無 
視されます。 


例： 


011111 1Y 77Q 63T 3FH 3F 

0100101010 0101Y 112450 47731 12AH 12A5 
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4.4 コマンドとパラメータの表記 


■アドレス 

アドレスは、、、くセグメント〉：くオフセット〉"という形式で指定します。セ 
グメントとオフセットは、数値やレジスタ名またはシンボルで指定します。セダ 
メントを省略すると、デフォルトのセグメントアドレスが与えられます0デフォ 
ルトのセグメントは、 Assemble コマンド、 Go コマンド、 Load コマンド 、 PTrace 
コマンド、 Unassemble コマンド、 Write コマンドの場合は CS レジスタ、それ以 
外のコマンドの場合は DS レジスタになります。 

例： cs : 0100 
04BA : IP 
CS : main 
DGROUP : count 

■ アドレスのレンジ指定 

アドレスのレンジ（範囲）を指定するには、つぎのような2種類の方法がありま 
す。 

書式 1 :開始アドレスと終了アドレスを指定する方法 
< 開始アドレス > < 終了アドレス > 

この書式では、<開始アドレス〉とく終了アドレス〉をスペースで区切って指定 
します。< 終了アドレス〉を省略した場合、128バイトの範囲になります。く終了 
アドレス〉にはセグメントの指定はできず、この場合そのセグメントはく開始ア 
ドレス〉で指定したものとおなじになります。 

例： cs :100110 

_main _main+20 


書式 2 :開始アドレスと長さを指定する方法 
< 開始アドレス > L< 数値 > 

この書式では、コマンドで処理する範囲は、<開始アドレス >からく数値>で示 
される範囲までとなります。この書式が使えるのは、 Dump コマンド、 Fill コマン 
ド、 Search コマンド、 Unassemble コマンドです 0 対象範囲の大きさや種類はコ 
マンドによって異なります。たとえば 、 Dump Bytes コマンドはバイト単位、 
Dump Words コマンドはワード単位、 Unassemble コマンドは命令単位になりま 
す。 

例： DGROUP : table L100 
main L20 
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■行番号 

行番号を指定するときの書式は、つぎのようになっています。 

. 土行番号 

.[ ファイル名：]行番号 

. シンボル [ 土行番号 ] 

ソースプログラム中の行番号は、先頭にピリオド （.） を付けて、10進数で指定 
します。 

最初の書式は、相対行番号を指定するものです。番号は、現在のソース行から 
新しい行までのオフセット（行単位）です。プラス記号 （+) の場合ソースファイル 
の後ろ、マイナス記号 ㈠ の場合はソースファイルの前を指定することになりま 
す。 

2番目の書式は、絶対行番号を指定するものです。ファイル名を指定すると、こ 
れによって示されたシンボルファイルに対応するソースファイル内の行番号を指 
定したことになります。ファイル名を指定しないと、現在のファイルの行番号を 
指定したことになります。 

3番目の書式は、シンボルからのオフセット（行番号）を指定するものです。プラ 
ス記号 （+) の場合ソースファイルの後ろ、マイナス記号 (-) の場合はソースファイ 
ルの前を指定することになります。 


例： .+5 
.10 

•sample :10 

.main 

.main+5 


;現在行から5行下の行 
;現ソースファイルの10行目 
; "sample^ というシンボルファイルが指定する 
ソースファイルの10行目 
； 、'main" の1行目 
; 、'main 〃の5行目 


シンボル、、 main 〃は、アドレスの指定にも使用できます。ただし、 、、 main +3 "が 
、' main " から3バイト目のアドレスを指定するのに対して、 、、. main +3" は、 、、 main " 
から3行目のソース行を指定するので注意してください。 


■ストリング 

ストリングは、クオーテーシヨン（”または’）で囲まれた任意の長さの文字列 
です。ストリングには、シングルクオーテーシヨン （’） かダブルクオーテーシヨン 
(”） を含めることもできます。ただし、始まりのクオーテーシヨンと終わりの 
クオーテーシヨンは同じものでなくてはなりません。ストリング中にさらに 
クオーテーシヨンを入れるときは、そのクオーテーシヨンを2個つづけて入力す 
るか、別の種類のクオーテーシヨンを用います。 
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例： This is a string.' 

” This is a string.” 
This ’’string” is okay.’ 
"This” ” string”，，is okay •，’ 
This ’’string” is okay.’ 
"This ’string’ is okay.” 


式は、 8 ビット、 16 ビット、 32 ビットの値を求めるオペランドと演算子の組み 
合わせです。式は、すべての コマンドで、 数値として用いることができます。 

式は、すべてのシンボルと数字、アドレスを、つぎに示す単項演算子および2項 
演算子を用いて組み合わせることができます。 


•単項演算子 


演算子 

意 味 

優先順位 

+ 

単項プラス 

高 

— 

単項マイナス 



NOT 

1の補数 



SEG 

オペランドのセグメント 



OFF 

オペランドのオフセット 



BY 

特定アドレスからのバイト 



WO 

特定アドレスからのワード 



DW 

特定アドレスからのダブルワード 



POI 

特定アドレスからのポインタ （4 バイト） 



PORT 

特定ポートからの1バイト 



WPORT 

特定ポートからの1ワード 

低 


•2 項演算子 


演算子 

意 味 

優先順位 

ホ 

乗算 

高 

/ 

整数の除算 



MOD 

余り 




セグメントのオーバライド 



+ 

加算 



— 

減算 



AND 

論理積 



XOR 

排他的論理和 



OR 

論理和 

低 
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式は、演算子の優先順に実行されます。隣りあった演算子の優先順位が同じ場 
合、式は左から右へ評価されます。カツコを用いれば、この順序を変えることが 
できます。 


會 


例： 式 式の評価 


4+2*3 

SEG 0001: 0002 
OFF 0001: 0002 
4 + (2 *3) 

(4+2)* 3 


= 10(0AH) 
=1 
= 2 

= 10(0AH) 
= 18(12H) 


4.5 SYMDEB のコマンド 

本節では、 SYMDEB のコマンドをアルファベット順に解説します。 SYMDEB のコマンドには、パラ 
メータを必要とするものがありますが、パラメータを省略したときは、デフォルトの値や、直前に行つ 
たコマンドの結果のレジスタ値が用いられます。 
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4.5 SYMDEB のコマンド 



Assemble 


命令をアセンブルしてメモリに入れる 


A [< アドレス >] 


解 


説 


8086/8087/8088/80186/80286/80287の命令をアセンブルして、その命令コードを指定されたアドレス 

に入れます （80286 のプロテクトモードは除く）。コマンドは、アドレスと指定されたアドレスの命令コー 

ドを表示して、次の命令のためのプロンプトを出します〇アドレスを入力しないと、 CS レジスタと IP レ 

ジスタの現在値によって与えられるアドレスから開始されます。アセンブルを終了したいときは、リタ 

ーンキーのみ押します。 

命令の入力に関する規則はつぎのとおりです。 

1. WAIT や REP などのプリフィックス命令は、それを適用する命令の前に指定します。これらは、 
別の行に分けて入力することもできます。 

2. FAR リターンのための命令は、 RETF です0 

3. ストリング(文字列）の操作に関する命令は、ストリングサイズを明確に指定します。たとえば、ワー 
ド列を移動する場合には MOVSW を用い、バイト列を移動する場合は、 MOVSB を使用します。 

4. JMP や CALL 命令では、 SHORT 、 NEAR 、 FAR が自動的に決定されます。これらは、 NEAR ま 
たは FAR プリフィックスを用いれば無効にすることができます。なお、 NEAR プリフィックスは、 
NE と略すことができます。 

5. オペランドがワード単位かバイト単位か判断できない場合は 、 WORD PTR または BYTEPTR プ 
リフィックスを用いて、データの種類を明確にしなくてはなりません 。 WORD PTR は WO、BYTE 
PTR は BY と略すことができます。 


例： 


MOV 

MOV 


WORD 

BYTE 


PTR 

PTR 


[BP]，1 

[SI-1],SYMBOL 


SYMDEB 
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6. オペランドがアドレスを示す場合は、、'□〃でく くります。そうでない場合は、値そのものを示す才 
ペランドと見なされます。 

例： MOV AX , 21 

MOV AX ,[21] 

7. 疑似命令の DB と DW を使うことができます。 DB はバイト値を、 DW はワード値をメモリに直接 


書き込みます。 


例： 

DB 

1, 2, 3, 4, ” THIS IS AN EXAMPLE ” 


DB 

THIS IS A QUOTE ’ 


DB 

"THIS IS A QUOTE :’ ，， 


DW 

1000, 2000, 3000,，， BACH ，， 


8. レジスタ間接指定が利用できます0 


例： ADD BX ，34[ BP +2][ SI -1] 

POP [ BP + DI ] 

PUSH [ SI ] 

9. すべての同義命令コード （ LOOPZ と LOOPE 、 JA と JNBE など）の表記が使用できます。 

10. 8087命令コードは、明確に指定しなくてはいけません。たとえば、 WAIT は8086命令コード、 
FWAIT は8087命令コードです。また、8087命令コードを使用するときは、システムに8087数値 
演算プロセツサが装着されている必要があります。 


[サンフル1 -A CS : _main 


この例では 、 、、CS : _ main 〃によって与えられるアドレスからアセンブルが開始 
されます。 


-A 04 BA : 0100 

この例では、、、〇 4 BA : 0100 " によって与えられるアドレスからアセンブルが開 
始されます。 
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4.5 SYMDEB のコマンド 


Breakpoint Set 


ブレークポイントを設定する 


巳 P [ n ] くアドレス> [く回数 >] 


解 


説 


指定されたアドレスにブレークポイントを設定します0プログラムの実行がブレークポイントに達す 
ると、プログラムは停止して、レジスタとフラグの現在値を表示します。このブレークポイントは、 G コ 
マンドが作成するブレークポイントと違って、 BC コマンドを用いて無効にしない限り、プログラム内に 
とどまります。 

ブレークポイントは、10個まで設定できます〇 [ n ] には、ブレークポイントの番号 (0 〜 9) を指定します。 
BP と [ n ] の間にスペースを入れてはいけません。 n を省略した場合は、最初に使用可能なブレークボイ 
ント番号が割り当てられます。 

くアドレス〉には、ブレークポイントのアドレスを指定しますが、これは命令コードの最初のバイト 
でなければなりません。 

<回数>には、ブレークボイントが有効になるまでに無視される回数を指定します。 


サンプル 


_main 


この例では、ブレークポイントが'' _ main 〃に設定されます。 


-BP8 add 


この例では、ブレークポイント8番が、、 add 〃に設定されます。 


-BP 10010 


この例では、ブレークポイントは、現在の CS セグメントの 100 H に作成されま 
す。このブレークポイントは、有効になるまでに 16(10 H ) 回無視されます。 


BP 


SYSDEB 
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Breakpoint Clear 

ブレーク ポイントを解除する 



BC {くリスト> I *} 


解 説 

BP コマンドで設定されたブレークポイントを削除します。< リスト > を入力すると、そこに挙げられ 
ているブレークポイントを複数削除します。リストは、0から9の整数値の組み合わせです。アスタリス 
ク （*) を指定すると、すべてのブレークポイントを取り除きます。 

サンプル I -BC 0 4 8 

この例では、ブレークポイント0、4、8番が取り除かれます。 

-BC * 

この例では、すべてのブレークポイントが取り除かれます。 
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4.5 SYMDEB のコマンド 


BD 


Breakpoint Disable 


ブレークポイントを一時的に無効にする 


巳 □ {< リスト> 丨 *} 


解 


説 


BD コマンドは、一時的にブレークポイントを無効にします。これは BE コマンドを用いていつでも復 
元できます。 

くリスト〉を入力すると、コマンドは、そこで挙げられている番号のブレークポイントを無効にしま 
す。くリスト〉の内容は、0から9の整数値の組み合わせです。アスタリスク （*) を入力すると、すべての 
ブレークポイントを無効にします0 


サンプル 


-BD 0 4 8 


この例では、ブレークポイント0、4、8番が無効になります。 


-BD * 


この例では、すべてのブレークポイントが無効になります0 


SYSDEB 
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BE 


Breakpoint Enable 

ブレークポイントを有効にする 



BE {くリスト〉| *} 


解 説 

BD コマンドによって一時的に無効となったブレークポイントを有効(復元）にします。くリスト〉を 
入力すると、そこに挙げられている複数のブレークポイントを有効にします。リストは、0から9の整数 
値の組み合わせです。アスタリスク （*) を入力すると、すべてのブレークポイントを有効にします。 


[ サンプル ] -BE 0 4 8 

この例では、ブレークポイント0、4、8番を有効にします。 

-BE * 

この例!では、すべてのブレークポイントを有効にします。 
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4.5 SYMDE 巳のコマンド 


Breakpoint List 


ブレークポイントの情報を表示する 


巳し 


解 


説 


BP コマンドで設定したブレークポイントの情報を表示します。実行すると、ブレークポイント番号、 
有効/無効の状態、ブレークポイントのアドレス、<回数〉の残り数、<回数〉の設定値（カッコ内）を表示 
します。 

ブレークポイントが設定されていなければ、何も表示されません。 


サンプル 


-BL 

0 e 04BA : 0100 
4 d 04BA : 0503 4(10) 
8 e 0D2D : 0001 3(3) 


この例では、ブレークボイント〇番と8番が有効 ( e ) で、ブレークボイント4番 
は無効 ( d ) になっています。ブレークポイント4番のく回数〉の設定は10で、あ 
と4回の残り回数があります。ブレークポイント8番の最初のパス数は3で、そ 
の3つのく回数〉をすベて残しています。ブレークポイント〇番には、最初のく 
回数〉がありませんが、これは1にセツトされたということです。 


BL 


SYSDEB 
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Comment 

注釈文(コメント)を表示する 



* <コメント> 


解 説 

アスタリスク （*) につづいて入力した文字を標準出力にエコーバックします。このコマンドは、 Redir ¬ 
ection (入出力の切り換え） コマンドで標準出力をフ ァイ ルやプリンタに切り換えているときに使用し、 
デバッグ作業の流れ(経過•工程）を記録として残しておきたいときなどに役立ちます。 

[ サンプル 1 -R CX 80 

-* Change the count in CX to 80 
Change the count in CX to 80 


46 









4.5 SYMDEB のコマンド 



Compare 

メモリ内容を比較する 



c <レンジ> <アドレス> 



くレンジ〉で指定した範囲のメモリの内容と、くアドレス〉から始まるメモリの内容を比較します0そ 
の結果、内容がすべて一致したときは、何も表示しません。一致しない場合は、その一致しない内容が 
表示されます。 


[サンプル I -C 100, IFF 300 

この例では、メモリの 100 H 番地から 1 FFH 番地までのブロックと、 300 H 番地 
から 3 FFH 番地までのブロックを比較します。 

-C 100 L 100 300 

この例では、メモリの10 0 H 番地から 256(100 H ) バイト目までと、 300 H 番地か 
ら256バイト目まで上匕較します。 
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Display 


<式>の値を表示する 



? <式> 


解 説 

く式〉を入力すると、それを評価して値を表示します。く式〉は、数、シンボル、アドレスおよび演算 
子を組み合わせたものです。コマンドは、式を評価してから、様々な形式でその値を表示します。形式 
には、完全アドレス16ビット16進数、32ビット16進数、10進数（カッコで囲まれている）、ストリン 
グ値（ダブルクオーテーシヨンで囲まれている）があります。 

[ サンプル ] -?3*4 

この例では、式、'3 *4〃 の値が表示されます。 

-? DS : table 

この例では、 シンボル アドレス、、 DS : table" の値が表示されます。 

-? WO DGROUP : _bufsiz 

この例では、 シンボル アドレス、、 DGROUP : -bufsiz" のワードが表示されます。 
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4.5 SYMDEB のコマンド 


Dump Ascii 


メモリ内容を ASCII 文字で表示する 


DA [< アドレス> I <レンジ >] 


解 


説 


指定した<アドレス〉またはくレンジ〉のメモリ内容を ASCII 文字で表示します0キャリッジリター 
ンやラインフイードなどの印字できないコードは、ピリオド （•） で表示されます。 

くアドレス〉を指定すると、最初の、' 00 H " にあたるまで、または128バイト分を表示するまで 、 ASCII 
文字を表示し続けます。< レンジ > を指定すると、コマンドは、その範囲が終わるまで、 ASCII 文字の表 
示を続けます。 

くアドレス> も < レンジ > も指定しなかった場合、コマンドは最初の、、 00 H 〃まで、または128バイトを 
表示するまで、 ASCII 文字の表示を行います0この場合、前回に表示された最終アドレスの次のアドレ 
スから、表不が開始されます。 


サンプル 


-DA CS :100110 

04BA : 0100 A STRING.Text.. 


この例では 、 ''CS :100〃から '' CS :110〃までの ASCII 文字が表示されます。印 
字できないコードはピリオド （.） で表示されます。 

-DA name 


この例では、シンボルアドレス、、 name 〃から ASCII 文字が表示されます 0 


DA 


SYMDS 
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メモリ内容を 16 進バイトと ASCII 文字で表示する 


Dump Bytes 



□巳 [< アドレス> 丨 <レンジ >] 


解 説 


指定した < アドレス > から128 (100 H ) バイト分、またはくレンジ > で指定された範囲のメモリ内容 
を、16進数と ASCII 文字で表示します。各行には、16個の16進バイト値とそれに対応する ASCII 文字 
が表示されます。印字できない ASCII 文字は、ピリオド （.） で示されます。 

くアドレス〉もくレンジ > も指定しなかつた場合、前回の Dump コマンドで表示された最終アドレス 
の次のアドレスから、表示が開始されます。 


[サンプル丨 -DBCS: 100110 


04BA : 0100 4120 73 74 72 69 6E 67-04 01 0154 65 78 74 0D A string-Text. 

04BA : 0110 0A 

この例では 、 ''CS :100〃から "110〃 までのバイト値が表示されます。対応する 
ASCII 文字は右側に表示されます。 


この例では、前回の表示アドレスの次から128バイト分が表示されます。たと 
えば、前回の Dump コマンドの際の最終バイトが'、 04 BA : 0110〃だった場合、 
XV 04 BA : 0111〃から表示が開始されます。 

-DB table table+5 

この例では、シンボルアドレス、 x table 〃から始まる6バイトが表示されます。 
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4.5 SYMDEB のコマンド 



Dump Words 


メモリ内容をワード (2 バイト)単位で表示する 


DW [< アドレス> I <レンジ >] 


解 


説 


指定した < アドレス〉から64ワード分、またはくレンジ > で指定された範囲のメモリ内容を、ワード 
(2 バイト）の16進数で表示します。各行には、8個の16進ワード値が表示されます。 

くアドレス> も < レンジ > も指定しなかった場合、前回の Dump コマンドで表示された最終アドレス 
の次のアドレスから、表示が開始されます。 


サンプル 


-DW CS :100110 

04BA : 0100 20417473 6972 676E 0104 5405 7865 0A0D 
04BA : 0110 002 E 


この例では 、 、、CS :100〃から 、、 CS :110〃までのワード値が表示されます。 


-DW 


この例では、現在のダンブアドレスから64ワード分が表示されます。たとえば、 
前回の Dump コマンドの際の最終バイトが'、 04 BA : 0110"だつた場合、 、、04 BA : 
0111〃からワードの表示が開始されます。 

-DW table table+5 


この例では、シンボルアドレス、、 table " から、、 table +5〃までのレンジのワードが 
表示されます。 


SYSDEB 
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メモリ内容をダブルワード (4 バイト)単位で表示する 


Dump Doublewords 



□D [< アドレス> | <レンジ >] 


解 説 


指定したくアドレス>から32個のダブルワード分、またはくレンジ>で指定された範囲のメモリ内容 
を、ダブルワード （4 バイト）の16進数で表示します。各行には、4個の16進ダブルワード値が表示され 
ます。 

くアドレス〉もく レンジ〉 も指定しなかつた場合、前回の Dump コマンド で表示された最終アドレス 
の次のアドレスから、表示が開始されます。 


[ サンプル ] -DD CS :100110 


04BA : 0100 7473 : 2041 676E : 6972 5054 : 0140 0A0D : 7865 
04BA : 0110 0000 : 002 E 


この例では、、ヽ CS :100〃から'、 CS :110〃までのダブルワードが表示されます。 


この例では、現在のダンプアドレスから32個のダブルワードが表示されます。 
たとえば、前回の Dump コマンドの最終バイトが 04 BA : 0110だった場合、 
04BA : 0111からダブルワードの表示が開始されます。 

-DD table table+5 

この例では、シンボルアドレス''、 table 〃から、、 table+5〃 までのレンジのダブル 
ワードが表示されます。 
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4.5 SYMDEB のコマンド 


Dump Short Reals 


メモリ内容をショート (4 バイト)の 
浮動小数点数で表示する 


□S [< アドレス> 丨 <レンジ >] 


解 


説 


指定した < アドレス > またはくレンジ > のメモリ内容を、ショート （4 バイト）浮動小数点数(実数）で 
表示します。16進数と10進数で表示され、10進数の表示形式は、つぎのとおりです。 

土 . dd...dE 土 mm 


SYMDEB は表示を行う前にショート実数をロング実数に変換します。そのため、最大16個の10進数 
を表示しますが、最初の7個の数字のみが有効です。コマンドは指定したレンジが終わるまで、または 
最初の1個のショート実数を表示するまで値を表示します。 


サンプル 


-DS ds :100 

04BA : 0100 00 00 20 40 +.25E+1 


この例では、アドレス、 Ms :100〃のショート実数が表示されます。1行につき1 
個の値だけが表示されます。 


-DS pi 


この例では、シンボルアドレス、、 pi 〃のショート実数が表示されます。 


DS 


SYSDEB 


53 










第 4 章 SYMDEB :シンボリックデバッガ 



メモリ内容をロング (8 バイト)の 
浮動小数点数で表示する 


Dump Long Reals 



DL [< アドレス > | < レンジ >] 


解 説 


指定した < アドレス > または < レンジ > のメモリ内容を、ロング (8 バイト）浮動小数点数(実数）で表 
示します。16進数と10進数で表示され、10進数の表示形式は、つぎのとおりです。 

土 . dd...dE 土 mm 

最高16個の10進数が表示されます。 

コマンドは指定したレンジが終わるまで、または最初の1個のロング実数を表示するまで値を表示し 
ます。 


[ サンプル 1 -DL ds :100 


04BA : 0100 86 37 6B F0 BE 2A 57 3F +.1 4139993273678774 E-2 

この例では、アドレス、、 ds :100〃のロング実数が表示されます01行につき1個 
の値だけが表示されます。 

-DL gamma 

この例では、シンボルアドレス、 amma" のロング実数が表示されます0 
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4.5 SYMDEB のコマンド 


DT 


Dump Ten - byte Reals 


メモリ内容を 10 バイトの浮動小数点数で表示する 


DT [< アドレス> 丨 <レンジ >] 


解 


説 


指定したくアドレス〉またはくレンジ〉のメモリ内容を、 10 バイトの浮動小数点数(実数）で表示しま 
す。 16 進数と 10 進数で表示され、 10 進数の表示形式は、つぎのとおりです。 

±.dd...dE エ mm 

最高 16 個の 10 進数が表示されます。 

コマンドは指定したレンジが終わるまで、または最初の1個の実数を表示するまで値を表示します。 


サンプル 


-DT ds: 100 

04BA : 0100 86 37 6B F0 BE 2A 57 3F 00 00 +.1 4139993273678774 E-2 


この例では、アドレス、 Ms :100 〃の 10 バイト実数が表示されます。 1 行につき 1 
個の数だけが表示されます。 

-DT gamma 


この例では、シンボルアドレス、 N gamma 〃の 10 バイト実数が表示されます0 


SYMDEB 
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Dump 

メモリ領域の内容を表示する 



D [< アドレス> | <レンジ >] 


解 説 

指定したくアドレス〉またはくレンジ〉のメモリ内容を、直前に実行された Dump コマンドと同じ形 
式でメモリを表示します。デフォルトでは、 DB コマンドと同じ形式です。 


[ サンプル ] -DA ds :100 

04BA : 0100 A string.. 
-D 

04BA : 01 OB Text... 


この例では、 DA コマンドで表示された直後のアドレスから、 ASCII 文字を表示 
します。 


-DW ds :100101 
04BA : 0100 2041 
-D ds : 324 325 
04BA : 0324 FE31 

この例では、 D コマンドはアドレス、、 ds : 324"のワードを表示します。 

-DS pi 

04BA : 0100 00 00 20 40+.25E+1 
-D gamma 

04BA : 0104 00 00 20 40+.25E+1 

この例では、 D コマンドは、シンボルアドレス、、 pi 〃の実数を表示します。 
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4.5 SYMDEB のコマンド 



Enter Ascii 


指定したアドレスに ASCII コード値を入れる 


EA <アドレス >[< リスト >] 


解 


説 


くリスト > には、ストリングか 16 進のバイト値、またはその両方をスペースかカンマで区切って指定 
します。ストリングを言己述するときは、クオーテーシヨン（”または’）で囲みます。< リスト〉を指定し 
ないと、アドレスとその現在の値およびピリオド （.） を表示して、値の入力を待ちます。この場合の操 
作は、 EB コマンドとまったく同じです。 


サンプル 


data 一 seg : msg2 ’’Can’t open file’’ 


この例では、ストリング、、 Can’t open file" の ASCII コードの値が、アドレス 
\'date_seg : msg2" 以降に書き込まれます。 


SYMDEB 
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指定したアドレスに八イト値を入れる 


Enter Bytes 



E 巳 <アドレス> [< リスト >] 


解 説 


<リスト>には、ストリングか16進のバイト値、またはその両方をスペースかカンマで区切って指定 
します。ストリングを言己述するときは、クォーテーシヨン（”または’）で囲みます。 EB コマンドは、 EA 
コマンドとまったく同じ働きをします。くリスト〉を指定しないと、アドレスとその現在値およびピリオ 
ド （.） を表示して、値の入力を待ちます。ここでは、つぎのように操作します。 

1. 新しい値を入力するときは、16進数の1桁か2桁をタイプします。それ以上の余分な数字や文字は 
無視されます。 


2. 次のアドレスへ進むときは、 | スペース 丨 キーを押します0 

3. 前のアドレスへ戻るときは、ハイフン （-) をタイプします。 

4. EB コマンドを終了するときは、リターンキーを押します0 
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4.5 SYMDEB のコマンド 


サンプル | -EB CS :100 2D E5 3 

この例では 、 CS •• 100に 2 DH、CS :101に E 5 H、CS :102に 03 H を入力した 
ことになります。 

-EB ES :100 

このように入力すると、つぎのような形式でプロンプトを表示します。 

04BA : 0100 EB. 

ここで、41とタイプすると、値 EB を新しい値 41( H ) に変更できます。 

04BA : 0100 EB.41 

1スペース I キーを押すと、次のバイトへ進みます。 

04BA : 0100 EB.4110. 

ハイフンをタイプすると、前の値へ戻ることができます。 

04BA : 0100 EB.41 10.- 

04BA : 0100 41. 


SYSDEB 
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第 4 章 SYMDEB :シンボリックデバッガ 



Enter Words 

指定したアドレスへワード値を入れる 



EW くアドレス >[< 数値 >] 


解 説 

指定したアドレスにワード値 （2 バイト）を書き込みます。く数値 >には、ワード値をスペースまたは力 
ンマで区切って複数指定できます。 

く数値〉をつけずに、アドレスだけを指定すると、そのアドレスから始まる1ワード分の現在のメモ 
リの値を表示し、ユーザーの入力を待ちます。ここで、4桁以内の16進数で値を入力し、リターンキー 
を押します。単にリターンキーを押すと、 EW コマンドを終了します。 EA や EB コマンドのように、ア 
ドレスを進めたり戻ったりすることはできません。 


[ サンプル ] -EW CS : 400 

2344 : 0400 ED32.8AD8 

2344 : 0402 1D3C. 


この例では、2344 : 0400" とその内容、、 ED32〃 が表示されているので、 、、8AD8〃 
をタイプしています。さらに、次のアドレスとその内容を表示していますが、こ 
の状態でリターンキーを押すと、 EW コマンドは終了します。 
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4.5 SYMDEB のコマンド 


Enter Doublewords 


指定したアドレスへダブルワード値を入れる 


ED <アドレス >[< 数値 >] 


解 


説 


指定したアドレスにダブルワード値 (4 バイト）を書き込みます。< 数値 > には、ダブルワード値をス 
ペースまたはカンマで区切つて複数指定できます。 

く数値〉をつけずに、アドレスだけを指定すると、そのアドレスから始まる1ダブルワード分の現在 
のメモリの値を表示し、ユーザーの入力を待ちます。ここで、8桁以内の16進数で値を入力し、リター 
ンキーを押します。単にリターンキーを押すと、 ED コマンドを終了します0 EA や EB コマンドのよう 
に、アドレスを進めたり戻ったりすることはできません。 


サンプル 


-ED CS :100 
2344 : 0100 
2344 : 0104 


440E :1234.1234 : 5678 
8ED9 : 1234. 


この例では、アドレス、、2344 : 0100〃とその内容、 40E :1234〃が表示されている 
ので、、、:1234 : 5678〃をタイプしています。さらに、次のアドレスとその内容を表 
示していますが、この状態でリターンキーを押すと、 ED コマンドは終了します。 


ED 
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第 4 章 SYMDEB :シンボリックデバッガ 



指定したアドレスにショート実数 (4 バイト)を入れる 


Enter Short Reals 



ES < アドレス >[< 数値 >] 


解 説 


指定したアドレスへ4バイト形式の浮動小数点値(実数）を書き込みます。く数値〉には、ショート実数 
をスペースまたはカンマで区切って複数指定できます。 

く数値>をつけずにアドレスだけを指定すると、そのアドレスから始まる4バイト分の現在のメモリ 
の 値を浮動小数点表示で示し、 ユーザーの 入力を待ちます。 

<数値 > を指定すると、指定されたアドレス （4 バイト分）の内容を変更し、続いて次のアドレスとその 
現在の値を表示し、ユーザーの入力を待ちます。 ES コマンドを終了するときは、リターンキーを押しま 
す0 


[ サンプル ] -ES pi 3.1415926 


この例は、シンボリックアドレス、、 pi" へ、3.1415926という数値をショート実数 
の形式で入れたものです。 ES コマンドで、アドレスだけを指定した場合は、つぎ 
のようになります。 

-ES pi 

210 C : 0130 -0.1256210825216E+16 +0.31415926e+l 

210C : 0134 -0.43093099806 1 5894E-3 1 

ES コマンドで入れた値を調べるには、 DS コマンドを用います。先頭バイトの 
アドレス、4バイトの内容、浮動小数点形式で表示した10進数の数値が表示され 
ます。この数値は、16桁で表示されますが、有効数字は小数点以下7桁までで、 
後ろの9桁は意味を持ちません。 
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4.5 SYMDEB のコマンド 



Enter Long Reals 

指定したアドレスにロング実数 (8 バイト)を入れる 



EL <アドレス >[< 数値 >] 


解 説 

指定したアドレスへ8バイト形式の浮動小数点値(実数）を書き込みます。く数値〉には、ロング実数を 
スペースまたはカンマで区切って複数指定できます。 

<数値〉をつけずにア•ドレスだけを指定すると、そのアドレスから始まる8バイト分の現在のメモリ 
の値を浮動小数点表示で示し、ユーザーの入力を待ちます。 

<数値 > を指定すると、指定されたアドレス （8 バイト分）の内容を変更し、続いて次のアドレスとその 
現在の値を表示し、 ユーザーの 入力を待ちます〇 EL コマンドを終了するときは、リターンキーを押しま 
す0 


[サンプル丨 -EL pi 3.141592653589793 

この例は、 シンボリック アドレス、、 pi 〃に、数値、、3.141592653589793〃をロング実 
数の形式で入れたものです。 EL コマンドで、アドレスだけを指定した場合は、つ 
ぎのようになります。 

-EL 210C : 0170 

210C : 0170 +0. 134328073584309 1E + 65299 +0 • 3141592653589793e +1 

210C : 0178 +0.1040230032441619E-71 
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第 4 章 SYMDEB :シンボリックデバッガ 



Enter Ten - byte Reals 

指定したアドレスに10バイト実数を入れる 



ET < アドレス >[< 数値 >] 


解 説 

指定したアドレスへ10バイト形式の浮動小数点値(実数）を書き込みます。< 数値 > には、実数をス 
ペースまたはカンマで区切つて複数指定できます。 

<数値〉をつけずにアドレスだけを指定すると、そのアドレスから始まる10バイト分の現在のメモリ 
の値を浮動小数点表示で示し、ユーザーの入力を待ちます。 

<数値 >を指定すると、指定されたアドレス （10 バイト分）の内容を変更し、続いて次のアドレスとそ 
の現在の値を表示し、ユーザーの入力を待ちます。 ET コマンドを終了するときは、リターンキーを押し 
ます。 


サンプル | -ET pi 3.141592653589793 


この例は、 シンボリックアドレス、、 pi 〃へ、数値、、 3.141592653589793 〃を 入れたも 
のです。 


-ET pi 

210C : 0150 +0 • 0204654128113587 E + 7898 +0.314152653589793e + l 
210C : 015A +0.5976239733286124E+3896 

この例は、 ET コマンドで、アドレスだけを指定した場合です。 
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第 4 章 SYMDEB :シンボリックデバッガ 


4.5 SYMDEB のコマンド 



Enter 


メモリの内容を変更する 


E <アドレス> [< リスト >] 


解 


説 


指定したくアドレス〉のメモリの内容を変更します。直前に使った Enter コマンド （ EA 、 EB 、 EW 、 
ED 、 ES 、 EL 、 ET などのメモリに値を書き込むコマンド）と同じ形式で内容を書き込みます0 

くリスト〉を指定すると、その値でメモリの内容を書き換えます0くリスト〉を指定しないと、アドレ 
スと現在のメモリの値とピリオド （.） を表示して、新しレゝ値の入力待ちになります。 


サンプル 


-EW ES :100 ABCD 
-E ES :100 

04 BA : 0100 ABCD .1234 
04 BA : 0100 0 D 0 A . 


雷 


SYMDEB 
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第 4 章 SYMDEB :シンボリックデバッガ 


4.5 SYMDEB のコマンド 



Examine Symbol Map 

シンボルマップ内のシンボル名とアドレスを表示する 



x [*] 


または 

X ? [< マップ名 >!] 

または 

X ? [< セグメント名> : ][< シンボル名 >] 


解 説 

現在のシンボルマップとそのマップ内のセグメントの名前およびロードセグメントアドレスを表示し 
ます。アスタリスク （*) を指定すると、コマンドはすべてのシンボルマップの名前とロードセグメントア 
ドレスを表示します。 

X ?コマンドは、シンボルマップ内の1つまたは複数のシンボルの名前とアドレスを表示します。、、く 
マップ名〉！〃を入力すると、コマンドはそのシンボルマップの情報を表示します。マップ名は、シンポ 
ルファイルのファイル名（拡張子の、'. SYM " は不要）です。、、くセグメント名〉："を入力すると、セグメン 
卜の名前とロードセグメントアドレスを表示します。セグメント名は、シンボルマップ内か、現在開か 
れているシンボルマップ内にあるセグメントの名前でなければなりません。、、くシンボル名>"を入力す 
ると、コマンドは、そのシンボルのセグメントアドレスとセグメントのオフセットを表示します。シン 
ボル名は、入力されたセグメント内のシンボルの名前でなければなりません。 

複数のセグメントやシンボルの情報を表示する場合、セグメント名やシンボル名にアスタリスク （*) 
をつけることができます。アスタリスクは、ワイルドカード的な文字として働くので、たとえば 、、、 F * : " 
は、文字、' F " で始まるすべてのセグメント名であり、、し*"は、アンダースコア （_) で始まるすべてのシ 
ンボルを表します。 
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4.5 SYMDEB のコマンド 


サンブル I -x 

この例では、現シンボルマップの名前と、そのマップ内のセグメントの名前と、 
ロードセグメントアドレスが表示されます0 

-X? test! 

この例では、シンボル マッ プファイル、、 test " のロー ドセグメントアドレスが表 
示されます。 

-X? igroup ' 

この例では、現在オープンしているシンボルマップ内の 、、 igroup 〃 という名前の 
セグメントのロードセグメントアドレスが表示されます。 

-X? start 

この例では、現在オープンしているシンボルマップ内のシンポル、' start " のセダ 
メントのアドレスと、セグメントのオフセットが表示されます。 

-X? igroup : start 

この例では、現在オープンしているシンボルマップ内のセグメント、、 igro 卬〃の 
シンボル、、 start 〃のセグメントのアドレスと、セグメントのオフセットが表示され 
ます。 

-X? code * 


この例では、現シンボルマツプ内の文字、、 code 〃で始まるすベてのシンボルのセ 
グメントのアドレス値とオフセツト値が表示されます。 


SYMDEB 
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第 4 章 SYMDEB :シンボリックデバッガ 



Fill 

指定した範囲を指定した値で埋める 



F <レンジ> <リスト> 


解 説 


指定したくレンジ〉内のアドレスのメモリを、< リスト〉の値で満たします。くリスト〉の長さがくレ 
ンジ> よりも短いときは、レンジ内のすべてのバイトが満たされるまで、くリスト> が繰り返して用いら 
れます〇< リスト > の値が < レンジ > のバイト数より大きい場合、余分な値は無視されます。 


[ サンプル ] -F CS :100 L 100 FF 

この例では、メモリの CS :100から CS : IFF までがバイト値 FFH で満たさ 
れます。 


-F DGROUP : table L 64 42 45 52 54 41 


この例では、 、、DGROUP : table" から100 (64H) バイトが、入力されたバイト値 
で満たされます。くリスト>の5個の値は、100バイトすべてが一杯になるまで繰 
り返されます。 
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4.5 SYMDEB のコマンド 



Go 


プログラムを実行する 


G [=< 開始アドレス >][[< ブレークポイントアドレス >]•••] 


解 


説 


指定したく開始アドレス〉からプログラムを実行します0プログラムは、終わるまで、またはくブレー 
クポイントアドレス〉に達するまで実行されます。また、プログラムは BP コマンドでセットされたブ 
レークポイントでも停止します0 

<開始アドレス > を省略すると、コマンドは、現在の CS : IP 値で示されるアドレスから実行を開始し 
ます。この場合の実行開始アドレスは、つぎのようになります。 

• 直前に G コマンドを実行している場合は、直前の G コマンドの終了アドレスの次のアドレスから開 
始されます。 

• SYMDEB 起動時、または L コマンドでファイルをロードした場合は 、 CS : 010 0 H 番地から開始さ 
れます。ただし、ロードしたファイルが EXE 形式の場合は 、 CS : IP の値がプログラム先頭にセッ 
卜されているため、そのアドレスから開始されます。 

• R コマンドで CS : IP の値を変更した場合は、そのアドレスから開始されます。 

なお、く開始アドレス〉を指定するときは、必ずイコール記号 (=) をつけます。 

くブレークポイントアドレス〉には、命令コードの最初のバイトを指定します。最大10個のブレーク 
ポイントアドレスを設定できます。ブレークポイントに達すると、すべてのレジスタとフラグの現在値 
を表示します。また、次に実行する命令の表示も行います。 

なお、 G コマンドの表示形式は 、 Set Source Mode コマンドの設定により、逆アセンブルモード、ソー 
スモード、ミックスモードの3種類を選択できます。 


注意 G コマンドは、 IRET 命令を用いてプログラムに制御を渡すために、ユーザースタックは最低 

6バイト必要です。ユーザースタックがこれより少なかったり、無効なメモリ内にある場合 、 MS 
- DOS のシステムメモリを破壊することもあります。 

ブレークポイントを設定すると、そのアドレスに INT 03 H 命令（害 IJ り込みコード 0 CCH ) を 
置き、ブレークポイントに達すると、これを元の命令に復元します。しかし、実行がブレーク 
ポイントを通らずにプログラムの最後まで続けられたり、何か他の理由で中止された場合、割 
り込みコードの置換は行いません。このため、プログラムを再開させる前に N コマンドと L コマ 
ンドを用いて、プログラムを再ロードしなくてはなりません。 

プログラムが 最後まで実行された場合 、 ''Program terminated normally 〃というメッセージ 
が表示されます。 
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第 4 章 SYMDEB :シンボリックデバッガ 


[ •ンプル] 


-G = CS ： 0 CS ： 7550 

この例では、アドレス 、、 CS : 0" のブログラムに実行の制御が渡されます。 
SYMDEB は、ブレークポイントアドレス 、、 CS : 7550〃に達すると、実行を中止し 
てレジスタとフラグの現在の値を表示します。 


-G 

この例では、 CS レジスタと IP レジスタの現在の値が示す命令へ制御が渡され 
ます。この コマンドは 一般に、ブレークポイントに達した後の実行の継続に用い 
られます。 


-G =_main add 


この例では、シンボルアドレス、、 _ main " が指すアドレスに制御が渡されます〇ブ 
レーク ポイントは、アドレス、、 add 〃にセツトされます0 
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4.5 SYMDEB のコマンド 



Help 


SYMDEB コマンドの一覧を表示する 




解 


説 


SYMDEB のコマンドの一覧を表示します。表示されるリストをつぎに示します。 


A[<address>] - assemble 
BC[<bp>] - clear breakpoint(s) 
BD[ 〈 bp>] - disable breakpoint(s) 

BE [ く bp 刈 - enable breakpoint(s) 
BL[<bp>] - list breakpoint(s) 

BP[bp] 〈 address〉■ set breakpoint 
C く range 〉 く address〉- compare 
D[type][<range>] - dump memory 
E[type] 〈 address 〉 [<list>] - enter 
F<range> く list〉- fill 
G[= く address 〉 [ く address〉."]] - go 
H く value 〉 く value〉- hexadd 
Kvalue) - input from port 
K[<value>] - stack trace 
L [ く addr> [ 〈 drive 〉 く rec> く rec>]] - load 


M<range> く address〉- move 

N く filename 〉 [ く filename〉."] - name 

0<value> <byte> - output to port 

P[= く address〉] [ く value〉] - program step 

Q- quit 

R[<reg>] [[=] 〈 value〉] - register 
S く range 〉 く list〉- search 
S{- | & I +} - source level debugging 
T[= 〈 address>] [ く value〉] - trace 
U[<range>] - unassemble 
V [ く range〉] - view source lines 
W[ 〈 address 〉 [ く drive 〉 く rec> く rec>]] - write 
X[?] く symbol〉- examine symbols(s) 

XO く symbol〉- open map/segment 
Z く symbol 〉 <value> 


? <expr> - display expression 
! [dos command] - shell escape 
display current source line 
¥- screen flip 


> } く device/file〉- Redirect output 
< { <device/file> - Redirect input 
=~ く device/file〉- Redirect both 
* 〈 string〉- comment 


く expr> ops : + _ 氺 / : not seg off by wo dw poi port wport mod and xor or 
く type 〉 ： Byte, Word, Doubleword, Asciz, Shortreal, Longreal, Tenbytereal 


SYMDEB 
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第 4 章 SYMDEB :シンボリックデバッガ 



Hex 

2 つの 16 進数の和と差を計算する 



H <数値1 > <数値2> 


解 説 

<数値1> と<数値2> を加算して結果を表示し、次に<数値1>からく数値2〉を引いてその結果を 
表示します。もしく数値2〉がく数値1> より大きければ、2つの値の差を2の補数として表示します。 

[サンプル] -H 3 4 

この例では、7と FFFF という結果が表示されます。 

-H 110100 

この例では、210と10という結果が表示されます。 
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4.5 SYMDEB のコマンド 



Input 


指定したポートから1バイトを読み込んで表示する 


I <ポート> 


解 説 


指定した I / O ポートから1バイトを読み込んで、2桁の16進数で表示します。 


サンプル 


2 F 8 


この例では、 I / O ポート番号， F 8" から読み取ったバイト値が表示されます。 


SYSDEB 
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第 4 章 SYMDEB :シンボリックデバッガ 



Loaa 

ファイルまたは指定したレコードを読み込む 



し [< アドレス >] 

または 

L <アドレス> <ドライブ> くレコード> くカウント> 


解 説 


N コマンドで指定されたファイルや、ディスク中の指定レコードのデータを、メモリに読み込みます0 
書式1 : L [くアドレス〉] 

N コマンドまたは SYMDEB 起動時のコマンドラインで指定したファイルを、指定したアドレスに 
ロードします。くアドレス〉を省略すると CS :100からロードされます。ロードされたファイルの長さ 
は 、 BX : CX レジスタにセツトされます。 

指定したファイルが COM 形式(拡張子が、、 . COM 〃） の場合、必ず CS :100からロードされるので、くア 
ドレス>を指定しても無効です0 

指定したファイルが EXE 形式(拡張子が、、 . EXE 〃） の場合、 EXE ファイルのへツダで指定されるアド 
レスにロードされ CS : IP の値はそのロードアドレスにセツトされます。したがって、 EXE ファイルの 
場合には、< アドレス > の指定は無効です0 

指名したファイルが HEX 形式(拡張子が、'. HEX ") の場合、そのファイルの開始アドレスとくアドレ 
ス〉を加算したアドレスにロードします〇くアドレス〉を指定しないと、ファイルはその開始アドレスに 
ロードされます。 

書式2 : L くアドレス〉くドライブ〉くレコード〉くカウント〉 

ディスクから直接、論理レコードをメモリにロードします。このときは、くアドレス〉、くドライ 
ブ>、< レコード >、< カウント > の値を明確に指定します。ドライブは読み込む先のドライブ番号で、 
ドライブ A :なら0、ドライブ B : なら1、ドライブ C : なら2••.というように指定します。くレコード〉 
は、ディスクから読み取る最初の論理レコード番号で、1〜4桁の16進数です〇< カウント〉は、ディス 
クから読み取るレコード数を、1〜4桁の16進数で指定します。 
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4.5 SYMDEB のコマンド 


[" サンプル I 


-N file.com 
-し 

この例では、、、 file . com " という名前のファイルが、メモリのアドレス CS :100に 
ロードされます。ロードされた長さ（バイト数）は 、 BX : CX レジスタペアに収め 
られます。 


-L DGR0UP : table 

この例では、シンボルアドレス 、' DGROUP : table 〃からファイルがロードされ 
ます0 N コマンドかコマンドラインで寸旨定されたファイルをロードします。 

-L workspace 2 34 3 

この例では、ドライブ C :⑵の論理レコード番号 52(34 H ) から始まる3つの 
論理レコードがメモリのシンボルアドレス、、 workspace 〃へロードされます 0 






第 4 章 SYMDEB :シンボリックデバッガ 



Move 

指定したメモリのブロックを移動(コピー)する 



M < レンジ > < アドレス > 


解 説 

<レンジ > で指定したメモリのブロックを、<アドレス > から始まる位置へ移動します。転送元と転送 
先が重なっていてもデータを損失することなく移動します0 くレンジ〉で指定したアドレスのメモリは、 
M コマンド実行後もそのまま残っています。ただし、転送先が転送元と重なった場合は、転送元が変更 
されます。 


「サンプル | -M CS :100110 CS ： 500 


この例では 、 CS :100から CS :110までのブロツクを 、 CS : 500から始まるメ 
モリに移動します。 


-M DS : table L 100 workspace 


この例では、シンボルアドレス'、 DS : table 〃の 256(100 H ) バイトをアドレス 
、 N workspace " に移動します。 
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4.5 SYMDEB のコマンド 



Name 


ファイル名などの引数をセツトする 


N <引数> [[< 引数 >] …] 


解 


説 


L コマンドや W コマンドのためにファイル名をセットしたり、プログラムの実行のために引数をセッ 
卜したりします。 

<引数〉を入力すると、スペースを含むすべての引数を DS : 81から始まる位置にコピーして 、 DS : 
80にコピーした文字数を セッ トします。 

最初の2つの引数がファイル名である場合、アドレス DS : 5 C とアドレス DS : 6 C にそれぞれファイ 
ルコントロールブロック （ FCB ) を作成して、このブロックに名前(正しい形式の名前）をコピーします。 
これによって、デバック中のプログラムが FCB を使用することができます。 

N コマンドによって影響を受けるメモリのアドレスはつぎのとおりです。 


DS : 5 C 1番目のファイル用 FCB 
DS : 6 C 2番目のファイル用 FCB 
DS : 80 文字の総数 

DS : 81 入力されたすべての文字 

N コマンドによっていったん引数をコピーすれば、デバッグ中のプログラムによってアクセスが可能 
となります。 


注意 Load や Write 用に新しいファイル名をセツトすると、前のプログラム引数は破壊されてしま 

いますので注意が必要です。 


SYMDEB 
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[サンプル j 


-N file.exe 

この例では、以後の L コマンドや W コマンドのために、ファイル名を、、 filel . 
exe 〃 にセットします。 

-N file.com test.dat 
-L 

この例では、 、、 test . dat 〃引数をセットして、 Afile . com " を読み込みます。ここで、 

-G 

として実行すると、これは、 MS - DOS のコマンドラインから、 

A>file test.dat 

と実行した結果と同じになります。 
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4.5 SYMDEB のコマンド 


Open Map 


シンボルマップまたはセグメントをセツトする 


XO [< マップ名> !]< セグメント名> 


解 


説 


、、くマップ名〉！"で指定したシンボルマップをアクティブにします0 くマップ名〉は、 SYMDEB コマ 
ンドラインに指定したシンボルファイルの中の1つでなくてはなりません。 

くセグメント>名を指定すると、指定されたセグメントをアクティブにします。くセグメント名〉 
は、くマップ名〉で指定したシンボルマップファイル内、または現在のシンボルマップ内の、セグメント 
の名前でなければなりません。 


サンプル」 -XO test! 

この例では、シンボルマップ lest 〃がアクティブになります。 

-XO testlgroup 

この例では、シンボルマップ、 est 〃とそのセグメント、 ' igroup 〃がアクティブに 
なります。 

-XO dgroup 


この例では、現在のシンボルマップのセグメント、、 dgroup 〃がアクティブになり 
ます。 


X0 


SYMDEB 
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Output 

1/〇ポートへ出力する 



口 <ポート > <バィト> 


解 説 

指定したくバイト〉を指定したくポート〉に出力します。くポート〉は16ビットのポートアドレスで 
す。 


[サンプル | -0 2F8 4F 

この例では、バイト値 4 F (16 進)が出カポート 2 F 8 へ送られます。 

-0 3 21 

この例では、バイト値 21(16 進)が出カポート3に送られます。 
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4.5 SYMDEB のコマンド 



割り込みに対応してトレースする 


P Trace 



p [=< 開始アドレス >] [ くカウント >] 


解 説 


指定したく開始アドレス〉から、くカウント〉で指定されたステップ数だけ、実行中のレジスタとフラ 
ダを表示します。 

く開始アドレス〉を省略すると、現在の cs レジスタと ip レジスタが示す命令から実行を開始しま 
す0イコール記号 0=) は、開始アドレスを入力する場合にのみ使います0 
くカウント〉を省略すると、1ステップだけトレースします。 

なお、 P コマンドの表示形式は 、 Set Source Mode コマンドの設定により、逆アセンブルモード、ソー 
スモード、ミックスモードの3種類を選択できます0 

注意 P コマンドは T コマンドとよく似ていますが、たとえば CALL 命令があった場合、 P コマン 

ドはそのサブルーチンを実行して、サブルーチン内の命令をステップ数としてカウントしませ 
ん。一方、 T コマンドはサブル_チン内の命令もステップ数として数えます。つまり' サプルー 
チンコール、ソフトウェア割り込み、ループなどのあるプログラムを P コマンドと T コマンド 
で ト レースした 場合、停止する位置が異なることになります。 


[サンプル I _P =_main 


この例では、、し main 〃の命令が実行され、レジスタとフラダの現在値が表示され 
ます。また、次に実行する命令も表不されます。 


この例では、現 CS レジスタと IP レジスタが示す命令が実行されます0 
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第 4 章 SYMDEB :シンボリックデバッガ 



Quit 


SYMDEB を終了する 



SYMDEB を終了し、 MS - DOS に戻ります。このとき、デバッグ中のプログラムはディスクに書き込 
まれません、必要であれば N コマンドでファイル名を指定してから、 W コマンドで書き込んでくださ 
い。 
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4.5 SYMDEB のコマンド 


Redirection 


入出力の切り換えを行5 


〈 <装置名> 
><装置名> 
=<装置名> 


解 


説 


SYMDEB の入力と出力を < 装置名 > で指名した装置に切り換えます。< 装置名 > には、デバイス名ま 
たはファイル名を指定します。 

<コマンドは、指定したく装置名〉からコマンド入力を読み込みます0 
>コマンドは、指定した<装置名>にコマンド出力を書き出します。 

=コマンドは、指定した<装置名>に対して読み込みと書き出しの両方を行います。 

装置名には、つぎのようなものがあります。詳しくは 「 MS - DOS ユーザーズリファレンスマニュアル」 
を参照してください。 


AUX 補助入出力装置 


CON 


コンソール 


補助入出力装置 ( AUX ) を用いる場合、ボーレートなどの設定や初期化を行っておく必要があります。 
一般に、 Redirection コマンドは、スクリーンを全面的に使用するプログラムをデバッグする場合に使 
います。 


注意 入力をコンソール以外に切り換えると、1 CTRL '] +1 Si キーと 丨 CTRL 丨 +1 C ] キーは無効と 
なります。 



SYiEB 
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第 4 章 SYMDEB :シンボリックデバッガ 


サンプル 


-> AUX 

この例では、 SYMDEB コマンドの出力が、、 AUX 〃の装置へ切り換えられます。 

-=AUX 

この例では、コマンドの入力と出力が、、 AUX 〃の装置へ切り換えられます。 

-く file.dat 

この例では、あらかじめ、 ' file . dat " に書いておいた SYMDEB のコマンドを入力 
させ、それを実行させます。 
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4.5 SYMDEB のコマンド 



Register 


レジスタ値を表示、設定する 


R [< レジスタ名> [< 数値 >]] 


解 


説 


レジスタに格納されている値を表示したり、逆にレジスタに値を入力したりします。 

<レジスタ名 > を省略すると、現在のレジスタおよびフラグと、 CS レジスタと IP レジスタが示す命 
令を表示します。 

<レジスタ名>を指定すると、指定したレジスタの現在の値を表示し、新しい値の入力を求めてきま 
す0 

<レジスタ名>と<数値〉の両方を指定すると、レジスタを指定された値に変更します。 

くレジスタ名〉は、つぎに示すうちの1つです。 


AX 

BP 

SS 

BX 

SI 

CS 

CX 

DI 

IP 

DX 

DS 

PC 

SP 

ES 

F 


IP と PC は同じレジスタ、つまり命令ポインタを指名するものです 0 F は、フラグレジスタの名前で 
す0 

レジスタの値を変更する場合は、レジスタ名と値を入力します 0 レジスタだけ指定して値を入力しな 
いと、レジスタ名、現在の値、そしてコロン （ ： ） のプロンプトが表示されます。新しい値をタイプして 
リターンキーを押してください。値を変更したくない場合は、リターンキーだけを押します。不適切な 
レジスタ名を入力すると 、 、、Bad Register " というメッセージが表示されますので、入力し直してくださ 


フラグの値を変更する場合は、レジスタ名として'、 F " を入力します。コマンドは、各フラグの現在値を 
2文字略号で表示します。フラグ値の略号のリストをつぎに示します。 


SYSDEB 
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フラグ 

セット 

クリア 

オーバー フ ロー 

方向 

割り込み 

符号 

ゼロ 

補助桁上げ 
パリティ 

桁上げ（キャリー） 

OV 

DN (減少） 
EI (有効) 
NG (負） 

ZR 

AC 

PE (偶数） 
CY 

NV 

UP (増加） 

DI (無効） 

PL (正） 

NA 

NA 

PO (奇数） 
NC 


、、 F " を指定すると、フラグ値とハイフン ㈠ が表示されます。ハイフンが示されたら、変更したいフラ 
グの新しい値を入力してリターンキーを押します。フラグの値の入力順序は任意です。値の間にスペー 
スは必要ありません。新しい値の入力されないフラグは、変更されません。どのフラグも変更したくな 
い場合は、リターンキーだけを押します。 

くレジスタ名〉として、、 F " を指定した場合は、その後にく数値〉を指定しても無視されます。 

1 つの フラグに対して複数の値を入力すると 、 、、Double flag ! 〃というメッセージが表示されます。上記 
以外の名前を入力すると 、、、: Bad Flag !" というメッセージが表示されます。どちらの場合も、エラーが発 
生するまでのフラグの変更は行われますが、エラーのフラグとそれ以後のフラグは変更されません。 

なお、 R コマンドの表示形式は 、 Set Source Mode コマンドの設定により、逆アセンブルモード、ソー 
スモード、ミックスモードの3種類を選択できます0 


「サンプル | -R 

AX = 0E00 BX = OOFF CX = 0007 DX = 01FF SP = 039D BP = 0000 
SI = 0050 Dl = 0000 DS = 04BA ES = 04BA SS = 04BA CS = 04BA 
IP = 011A NV UP Dl NG AC PE NC 
04BA : 011A CD21 INT 21 

この例では、 CS レジスタと IP レジスタの指すアドレスの命令に加えて、すべ 
てのレジスタとフラグの値を表示します。命令は最後に表不されます。 


-R AX 

この例では、 AX レジスタの現在値と、新しい値に対するプロンプトをつぎのよ 
うに表示します。 

AX 0E00 
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4.5 SYMDEB のコマンド 


コロン（： ） の後に16ビットの値をタイプします。変更したくない場合には、リ 
ターンキーを 押します。 


-RF 


この例では、現在のフラグ値と変更を求めるプロンプトをつぎのように表示し 
ます。 


NV UP Dl NG NZ AC PE NC 一 


フラグ値の変更には、このプロンプトの方法を用いてください。 


-R IP 100 


この例では、 IP レジスタが値100に変更されます。 


SYMDEB 
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Search 

バイト値を検索(サーチ)する 



s < レンジ > < リスト > 


解 説 

指定したくレンジ〉のメモリからくリスト>で指定したバイト値を検索します。見つかると、そのア 
ドレスを表示します。そうでない場合は、何も表示せず、 SYMDEB のコマンドプロンプトを表示します0 
くリスト>には1つ以上のバイト値またはストリングを指定します。複数のバイト値を指定する場合 
は、スペースかカンマで区切らなければなりません。文字列の場合はシングルクオーテーシヨン （ ’ ） かダ 
ブルクオーテーシヨン （”） で囲みます。 


| サンプル I -S CS :100 200 41 

この例では 、 CS :100から CS : 200の範囲内でバイト値41を検索します。 

-S table L 100，’ Fix up” 

この例では、シンボルアドレス、、 table 〃から始まる 256(100 H ) バイトの範囲で 
、、Fix up 〃 という文字列を検索します。 
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4.5 SYMDEB のコマンド 



Set Source Mode 


命令コードの表示形式を設定する 


s{- 1 +1 S} 


解 


説 


G コマンド、 P コマンド、 R コマンド、 T コマンドおよび U コマンドが表示する形式を設定します。 
以下の3つのモードを設定できます。 

書式1: S - 

逆アセンブルモード。命令コードのみが表示されるモードとなります。 

書式2: S+ 

ソースモード。表示すべき命令に対応する実際のプログラムのソース行が表示されるモードとなりま 
す。 

書式3: S& 

ミックスモード。命令コードとソース行の両方が表示されるモードとなります。 

ただし、ソース行は、 S+ コマンドか S& コマンドが入力されていて、さらに行番号の情報を持つシン 
ボルファイルが口ードされている場合に限って表示することができます。シンボルファイルをロードし 
ていなかったり、シンボルファイルに行番号の情報が入っていないと、以後のソース行表示の要求を無 
視します。 

ソース行は''行番号：ソース〃の形式で表示され、命令コードが表示される前に表示されます。 


サンプル 


-S + 


この例では、ソース行のみの表示形式にセットします。 


-S& 


:の例では、ソース行と命令コードの表示形式にセツトします。 


書 


SYMDEB 
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Shell Escape 

SYMDEB 中から、 MS - DOS コマンドを実行する 



KMS - DOS コマンド> 


解 



SYMDEB の中から、く MS - DOS コマンド〉で指定した MS - DOS のコマンドを子プロセスとして実 
行します。く MS - DOS コマンド〉を省略すると、、 COMMAND . COM " のみを実行するため、 MS - DOS の 
プロンプトが表示されます。この状態では、通常の MS - DOS モードと同様に操作を行うことができま 
す。 SYMDEB に戻るときは、 、、 EXIT " コマンドを用います。 


参考 


! (Shell Escape ) コマンドを実行するためには、デバッグ中のプログラムが不必要なメモ 
リを開放するようになっていなくてはいけません。不必要なメモリを開放するためには、 
プログラムで MS - DOS のファンクションコール 4 AH (割り当てられたメモリブロックの 
変更）を用います0このファンクション コールに よって、 MS - DOS は、 COMMAND.COM 
をロードするメモリ領域を確保することができます。同様のことが、 LINK (リンカ）の 
/ CPARMAXALLOC スイッチでも行えます。 

Microsoft C Ver 3.0 以上で開発したプログラムで、 _ main 関数の実行後であれば、自動 
的にメモリは開放されます 0 Microsoft Pascal . FORTRAN Ver 3.30 以上で開発されたプ 
ログラムでも、最初の手続きの実行後であれば、メモリは自動的に開放されます。 
SYMDEB 自身をロードした場合でも、メモリは開放されます。しかし、 MASM または前 
述のコンパイラと同様の機能を持たないコンパイラで開発したプログラムのデバッグを行 
うときは、メモリの開放を行わないと！ (Shell Escaspe ) コマンドは実行できません 0 


[サンプル I -! dir b : *.asm 

この例は、 MS - DOS のコマンドモードで 、、 dir b : *. asm " を実行したときと同じ 
ように表示され、その後再び SYMDEB のコマンド入カモードに戻ります。 

-! chkdsk b : 

この例は、 MS - DOS の外部コマンド、、 CHKDSK 〃を実行するものです。このよ 
うに外部コマンドやバッチファイルも実行できます0 
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4.5 SYMDEB のコマンド 



Source Line 


現在のソース行を表示する 


•(ピリオド） 


解 


説 


Source Line コマンド （.） は、高級言語によるプログラムのデバッグに用いるコマンドです。たとえば、 
プログラムをブレークポイントで停止させた時点で、ピリオド （.） を入力すると、そのときのソースモー 
ド (Set Source Mode コマンド参照）に関係なく、現在のソース行を表示します 0 
なお、このコマンドは、 MASM 、 SYMDEB と互換性の無いコンパイラで開発したプログラムでは無 
効です。 


注意 


ソース 行に2バイト文字が含まれている場合、表示が乱れることがあります。 


サンプル 


for (i = 0 ； i <= SIZE ; i ++) 


この例は、 SYMDEB と互換性のある C コンパイラで開発したプログラムをデ 
バッグ中のものです。 


SYMDEB 
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Stack frace 

スタックフレームの内容を表示する 



K [く値〉] 


解 説 

K コマンドは、現在のスタックフレームの内容を表示します。表示される項目は、現在の手続きと引 
数、コールされている手続きおよび引数です。さらに、各手続きをコールしているファイルと ソース 行 
の行番号も表示されます。 

パラメータ <値>が指定されると、その値の数まで引数が16進数で表示されます。 


[ サンプル | -K 

IGROUP : _max (0002,0003) from .sample.c i 7 
IGROUP : _main ⑺ 

この例では、現在の手続きは、' _ max 〃で、2つの引数、、0002 H 〃と、'0003 H 〃である 
ことが分かります。また、この手続き 、、_ max 〃は、ソースフアイル、、 sample . c 〃の7 
行目の手続き、、- main 〃からコールされており、、し main " の引数は不定であること 
も分かります。 

-K 3 

IGROUP : max (0002,000 3) 什 om..sample.c : 7 
IGROUP : main (0002,2 F 62,2 EBA) 

この例では、手続き、二 main 〃の引数が、3個まで表示されています。 
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4.5 SYMDEB のコマンド 



Symbol Set 


シンボリックアドレスに値をセツトする 


z <シンボル> <値> 


解 説 


指定した<シンボル>のアドレスへ指定した<値>を入れます。 


サンプル 


-l close 26 


この例では、シンボル、、 close 〃のアドレスへ 26 H をセツトしています。 


SYSDEB 
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T race 

プログラムの実行をト レースす る 



T [=< 開始アドレス >][< カウント >] 


解 説 


指定した < 開始アドレス〉から、くカウント〉で指定されたステップ数だけ、実行中のレジスタとフラ 
グを表示します。 

く開始アドレス〉を省略すると、コマンドは、現在の CS : IP 値で示されるアドレスから実行を開始し 
ます。この場合の実行開始アドレスは、つぎのようになります。 

• 直前に T コマンドを実行している場合は、直前の T コマンドの終了アドレスの次のアドレスから 
開始されます。 

• SYMDEB 起動時、または L コマンドでファイルをロードした場合は 、 CS : 010 0 H 番地から開始さ 
れます。ただし、ロードしたファイルが EXE 形式の場合は 、 CS : IP の値がプログラム先頭にセッ 
卜されているため、そのアドレスから開始されます。 

• R コマンドで CS : IP の値を変更した場合は、そのアドレスから開始されます。 

なお、く開始アドレス〉を指定するときは、必ずイコール記号(二）をつけます。 

くカウント〉を省略すると、1ステップだけトレースします。 

なお、 T コマンドの表示形式は 、 Set Source Mode コマンドの設定により、逆アセンブルモード、ソー 
スモード、ミックスモードの3種類を選択できます。 


参考 T コマンドは、 8086/8088/80186/80286/386/486 マイクロプロセッサのハードウヱ アト 

レースモードを使用するので 、 ROM (読み取り専用メモリ）に記憶されている命令をトレー 
スすることもできます。 
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4.5 SYMDEB のコマンド 


厂サンプル」 


-T 二 — main 

この例では、 _ main からの命令が実行され、レジスタとフラグの現在値を表示 
します。また、次に実行する命令も表示します。 


-T 

この例では、現在の CS レジスタと IP レジスタの示す命令が実行されます0 

-T =011A 10 

この例では、現在の CS セグメントの 011 A から、16 (10 H ) ステップだけ命令が 
実行されます。 
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Unassemble 

メモリ内容を逆アセンブルする 



u [< レンジ >] 


解 説 

デバッグ中のプログラムの命令、プログラム文、またはその両方を、指定されたくレンジ>の範囲分 
だけ表示します。くレンジ〉を省略すると、8行分だけ表示します。表示形式は 、 Set Source Mode コマ 
ンドの設定により、つぎの3種類を選択できます。 

形式1:逆アセンブルモード ( S -) 

命令コードの表示。指定されたくレンジ > の範囲を逆アセンブルして表示します。その形式は、 A コ 
マンドと同じです。シンボルマップがプログラムと共にロードされている場合、ラベルや変数や絶対シ 
ンボルを表すオペランドは、アドレスではなく名前で表示されます。 

形式2:ソースモード （ S +) 

プログラムのソース行の表示。指定されたくレンジ>に対応するソース行を表示します。 

形式3 :ミックスモード （ S &) 

ソース行と命令コードの表示。逆アセンブルモードとソースモードをミックスしたものです。 

ソースモードとミックスモードの場合、シンボルマップがプログラムと共にロードされることと、ソー 
スファイルの行番号情報がそのマップ内にあることが必要です。プログラムの入力された部分に対する 
行番号情報がない場合、ソース行は表示されません。 

逆アセンブルモードとミックスモードを用いる場合は、 SYMDEB は、8ビットの即時オペランドの16 
進値と ASCII 値の両方を表示します。16進値は命令の一部として表示され、 ASCII 値は同じ表示行中の 
セミコロン （ ； ） の直後に表示されます。 

8086と8087の命令コードの表示のみが可能です。 

注意 ソース行に2バイト文字が含まれている場合、表示が乱れることがあります。 


[サンプル] 形式1:逆アセンブルモード 


-U CS : 02 AD 
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4.5 SYMDEB のコマンド 


この例では、アドレス 、、 CS : 02 AD " から8行分を逆アセンフルしてつぎのよつ 
に表示します。 


1156 : 

02AD 

55 

PUSH 

BP 

1156 : 

: 02AE 

8BEC 

MOV 

BP，SP 

1156 : 

: 02B0 

B802C0 

MOV 

AX， 0002 

1156 : 

: 02B3 

E893FF 

CALL 

chkstk 

1156 : 

: 02B6 

C746FE 6100 

MOV 

Word Ptr[BP-02]， 0061 

1156 : 

: 02BB 

FF0EEC05 

DEC 

Word Ptr[05EC] 

1156 

: 02BF 

833EEC0 500 

CMP 

Word Ptr[05EC]，+00 

1156 

: 02C4 

7C11 

JL 

02D7 


形式2: ソースモード 


-U _main L 5 


この例では、アドレス、、 _ main " から5行分のソース行をつぎのように表示しま 


す0 


int i ; 

for(i=，a’ ； K’z’ ； i++) 
putchar(i)； 


形式 3: ミックスモード 


-U CS : 02 AD 


この例では 、 、、CS : 02 AD 〃から8行分の命令コードとプログラムソースコード 
をつぎのように表示します。 


4 : { 

IGROUP : _main 
1156：02AD 55 
1156 : 02AE 8BEC 
1156 : 02B0 B 80200 
1156 : 02B3 E893FF 
7 : for(i =’a’ ； K’z’ ； i++) 


PUSH 

BP 

MOV 

BP,SP 

MOV 

AX, 0002 

CALL 

chkstk 

MOV 

Word Ptr[BP-02], 0061 


SYMDEB 
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View 

指定したアドレスから ソース 行を表示する 



v [< アドレス >] 


解 説 

V コマンドは、筒級目語によるプロクフムに用いるコマンドで、ソ'ースモードの設定 (Set Source 
Mode コマンド参照）に関係なく、指定したアドレスから始まるソース行を表示します。 

このコマンドを用いるためには、ソースプログラムファイル中の行番号に関する情報を持ったシンポ 
ルファイルが必要です。 MASM 、 SYMDEB と互換性の無いコンパイラで開発したプログラムではこの 
コマンドは無効です。 

注意 ソース行に2バイト文字が含まれている場合、表示が乱れることがあります。 


「サンプル "! -V _func 

4 ： { 

5 : int i ； 

6 : 

7 : for(i=’a’ ； K’z’ ； i++) 

8 : putchar(i); 

9 : for(i= ， A’ ； K’Z’ ； i++) 

10 * putchar(i); 

11 : for(i =’0’ ； K ， 9’ ； i++) 


この例は、 C コンパイラによるもので、アドレス、、 _func 〃から始まるソース行を 
表示したものです。同様のことを、 FORTRAN や Pascal で開発したプログラム 
でも行うことができます。 
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4.5 SYMDEB のコマンド 



Write 


ファイルまたはメモリ内容をディスクに書き込む 


w [< アドレス >] 

または 

W くアドレス> くドライブ> くレコード> くカウント> 


解 


説 


N コマンドで指定されたファイルや、ディスク中の指定レコードに、メモリ中のデータを書き込みま 


す0 


書式1 : W [くアドレス〉] 

指定した <アドレス >から 、 BX : CX レジスタにセットされた長さのメモリ内容をディスクに書き込 
みます。<アドレス〉を省略すると CS :100から書き込みます。 

W コマンドを使う前に、 R コマンドでファイルの長さを BX : CX レジスタにセットし、 N コマンド 
でファイル名を指定しておく必要があります。ただし、 SYMDEB 起動時、または L コマンドでファイ 
ルをロードした場合、それらの値は自動的にセットされるため、値をとくに変更しない限り、改めてセッ 
卜する必要はありません。 

なお、 EXE 形式および HEX 形式のファイルをロードしている場合、 W コマンドで書き込みをするこ 
とはできませんので注意してください。 

書式 2 : W< アドレス〉くドライブ〉くレコ-ド〉くカウント〉 

ディスクの論理レコードに、メモリ内容を直接書き込みます。このときは、<アドレス〉、くドライ 
ブ>、くレコード >、< カウント > の値を明確に指定します。ドライブは書き込む先のドライブ番号で、 
ドライブ A :なら0、ドライブ B : なら1、ドライブ C : なら2••.というように指定します。くレコード〉 
は、ディスクに書き込む最初の論理レコード番号で、1〜4桁の16進数です。くカウント〉は、ディスク 
に書き込むレコード数を1〜4桁の16進数で指定します0書き込まれるメモリ内容のバイト数は、このく 
カウント >で指定されたレコード数に相当する分となります0 


注意 


:れは、ディスクの内容を破壊する可能性のあるコマンドなので、十分注意して使ってくだ 


さい 


参考 


G コマンド 、 P コマンド、 T コマンドが実行された場合、 ロード されたファイルのファ 
イル名、長さおよび開始アドレスを正しい値にセットしなくてはなりません0また、 R コ 
マンドで BX レジスタと CX レジスタを修正してある場合、これらのレジスタも正しい値 
にセットしなくてはなりません。 


SYMDEB 
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[サンプル I 


-N table.bin 
-R BX 
BX 0100 
: 0000 
-R CX 
CX D43C 
: 0100 

-w DGROUP : table 

この例では、アドレス 、、 DGROUP : table "からの 256(100 H ) バイトを、、 table , 
bin " というファイル名で書き込みます。 

W workspace 2 34 3 

この例では、アドレス、、 workspace " から始まるメモリの内容を、ドライブ C :に 
セットされたディ スタのレコー ド番号 52(34 H ) から3つ目までの論理レコード 
に、相当するバイト数分書き込みます。 
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4.6 メッセージ 


4.6 メッセージ 

SYMDEB は、実行できない コマンド や不正なパラメータを見つけると、エラーメ ッ セージを表示しま 
す0 

通常は、発生したエラーに対して、記号 r ) と、、 Error "というメッセージを表示します。記号〇は、コ 
マンドライン中のエラーの位置を示すものです。つぎの例は、 D コマンドの値の範囲が適切でないこと 
を示しています。 

例： d cs :100 0 

"Error 

また SYMDEB は、エラーメッセージ以外にも、コマンドの実行状況をくわしく伝えるメッセージを 
表示します。つぎに、それらのメッセージとその意味を示します。 

Access denied 

リードオンリーファイルに書き込むことはできません。 


Bad breakpoint number! (0-9) 

ブレークボイントの番号が間違っています。0から9までの数字で指定してください0 


Bad Flag! 

フラグが間違っています。フラグを変更しようとしましたが、タイブした文字は許容されているフラ 
グ値ではありませんでした。正しいフラグ入力値のリストについては、 R コマンドを参照してください。 

Bad register 

R コマンドで、間違ったレジスタ名が入力されました。正しいレジスタ名のリストについては、 R コ 
マンドを參照してください。 

Breakpoint list or expected! 

BC コマンド、 BD コマンド、または BE コマンドで、ブレークポイントのリストを入力せずにコマン 
ドを実行しました。 


Double flag! 

1つのフラグに対して2つの値を入力しました。指定できるフラグ値は1つだけです。 R コマンドを参 
照してください。 


Error in EXE or HEX file 

ロードした EXE 形式または HEX 形式のファイルが、正しくありません。 

Error reading .SYM file 

SYMDEB のコマンドラインに指定したシンボルファイルが読み取れませんでした。 
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EXE and HEX files cannot be written 

EXE 形式と HEX 形式のファイルを、ディスタに書き込むことはできません。 

EXEC failure 

実行したプログラムは、異常終了しました。 

File creation error 

システムファイル、または隠しファイルに書き込みをしようとしました。ファイルの属性を確認して 
ください。 

File not found 

指定されたファイルが見つからないため、ロードできません。正しいファイル名を Name コマンドで 
指定しなおしてから、 Load コマンドを実行してください。 

Incorrect DOS version 

DOS のバージョンが違います。動作可能な DOS のバージョンで起動してください。 


Insufficient memory 

メモリ容量が足らないため、プログラムを正常に実行できません。 


Insufficient space on disk 

ディスク容量に十分な空きがないため、書き込むことができません。 

Invalid drive specification 

指定されたドライブ番号が正しくありません。ドライブ番号は、ドライブ A :なら0、ドライブ B : な 
ら1、ドライブ C :なら2 .••というように指定します。 


Parity error or nonexistant memory error detected 

パリテイエラーか、または非実裝アドレス領域へのアクセスによりメモリエラーが発生しました。 


Program terminated and stayed resident 

実行したプログラムは、システムメモリ上に常駐終了しました。 


Program terminated normally 

実行したプログラムは、正常終了しました。 


Program terminated with hard error 

実行したプログラムは、 ハードウェアのエラーに より、異常終了しました。 

SYM files cannot be written 

SYM ファイルを、ディスクに書き込むことはできません。 
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Too many breakpoints! 

G コマンドのパラメータとして与えられた ブレーク ポイントの数が1〇個を越えています。1〇個以下 
のブレーク ポイントで G コマンドを入力し直してください。 


Value out of range 

指定されたパラメータの値が指定可能な範囲内にありません。正しい値を指定してください。 

Writing xx bytes 

xx バイト分、ディスクに書き込みました。 
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4.7 SYMDEB の使用できるアセンブラとコンパイラ 

SYMDEB / MAPSYM のシンボリ ック デバ ッグ 機能は、 つぎに 示す言語で記述され たプログラムに 使 
用できます。 

Microsoft FORTRAN version 3.0 以上 

Microsoft Pascal version 3.0 以上 

Microsoft C version 2.0 以上 

Microsoft Macro Assembler version 1.0 以上 

Microsoft Basic Compiler version 1.0 以上 

Microsoft Business Basic Compiler version 1.0 以上 

SYMDEB / MAPSYM のソース行表示機能は、正しい行番号の情報を生成するコンパイラで使用でき 
ます。ソース行番号の情報を自動的に生成するコンパイラをつぎに示します。 

Microsoft FORTRAN version 3.0 以上 
Microsoft Pascal version 3.0 以上 

つぎに、ソース行番号の情報を生成する場合にコマンドライン中にスイッチが必要なコンパイラを示 
します。コンパイラのスイッチについては、言語のマニュアルを參照してください。 

Microsoft C version 2.0 以上 
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第匕/章 

LIB :ライブラリ マネージャ 


5.1 イントロダクシヨン 

ライブラリファイルは、他のプログラムが実行時に必要とする、、オブジェクトモジュール〃の集まりで 
す。ライブラリマネージャ： LIB は、このライブラリファイルの作成、管理を行うためのユーティリティ 
です。 

ライブラリは、 LINK によって用いられます。 LINK は、プログラム中の外部參照を解析し、それを 
ライブラリファイルから捜し出して、参照を解決し、実行可能なプログラムを作成します。 

LIB は、、、オブジェクトファイル"を取り込んで、ライブラリファイルを作成します。オブジェクトファ 
イルは、1つのオブジェクトモジュールから成るもので、ユーザーが MASM や高級言語コンパイラで作 
成します。 LIB は、オブジェクトモジュールをライブラリファイルに追カロ•登録すると、このモジュール 
名をライブラリファイルの、、ライブラリ見出しテーブル〃に登録します。 LINK は、ライブラリファイル 
を参照するとき、この見出しテーブルをチェックし、必要なモジュールが登録されているか調べます。 
目的のモジュールが見つかると、 LINK はこれを処理中のプログラムとリンクします。 


5.2 L 旧の起動と使い方 

LIB を使うときは、ライブラリファイル名、スイッチなどのパラメータを指定します。パラメータの 
指定方法にはつぎの3種類あります。 


1. コマンドラインでの指定方法 

2. LIB のプロンプトでの指定方法 

3. 応答ファイルでの指定方法 

パラメータが不足しているときは、必要な情報の入力を求めるコマンドプロンプトを表示します。い 
ずれの方法で LIB を起動した場合でも、 「 CTRL 1 + [^ J キーを押すことでいつでも中止することができ 
ます。以下、それぞれの指定方法で LIB を起動する方法を述べていきます。 
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■ コマンドラインでの指定方法 

このコマンドの書式は、つぎのとおりです。 

LIB くライブラリファイル名 〉 [/PAGESIZE : n ] [くコマンド>…] 

[，リストファイル名，出カファイル名] 

<ライブラリファイル名〉 

処理の対象とするライブラリファイル名です。新規に作成または編集するライ 
ブラリファイル名を指定します。なお、ライブラリファイル名の拡張子が、、丄 IB 々 
の場合は、これを省略することができます。 


/PAGESIZE : n 

これは、ライブラリのページサイズ （5.2 節中の「ライブラリページサイズの設 
定」参照）を指定するもので、省略した場合は、自動的にページサイズは16となり 
ます。 


<コマンド> 

LIB に対する指示です。ライブラリファイルに対して追加、削除などを行うモ 
ジュール名やライブラリファイル名に、コマンド文字をつけて指定します。この 
コマンドについては、 5.3「 LIB のコマンド」で詳しく解説します。くライブラリ 
ファイル名〉だけを指定して、コマンドを指定しないと、 LIB は、ライブラリの 
整合性をチヱックします。これについては、 5.2 節中の「ライブラリの整合性の 
チエック」を参照してください。 

<リストファイル名> 

ライブラリのクロスリファレンスリストファイルを作成したいときにそのファ 
イル名を指定します。このクロスリファレンスリストファイルには、ライブラリ 
中のモジュールの PUBLIC シンボル名が、一覧表になって収められます。この指 
定を省略するとプアイルは作成されません。 


<出カファイル名> 

処理を行った結果を収める新しいライブラリファイル名を指定します。出力 
ファイル名を指定しなかった場合、 LIB は指定したライブラリファイルそのもの 
を編集しますが、この出カファイル名を指定すると、編集の対象になったライブ 
ラリは元の状態で残され、編集された新しいライブラリファイルが作られます。 
元のライブラリファイルをそのままの状態で残しておきたいときに指定します。 

ライブラリファイルがカレントディレクトリにない場合は、ドライブ名やパス 
名を含めてくライブラリファイル名 > を指定してください。 

<リストファイル名〉を指定するときは、最後のくコマンド〉の後に、区切り 
記号のカンマ （ ， ） を入れます。この区切り記号は、くリストファイル名〉とく出力 
ファイル名〉の間にも必要です。< リストファイル名> を省略してく出カフアイ 
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ル名〉を指定するときは、くコマンド〉との間にカンマを2つし，）入れます。 

コマンドラインの任意の場所に、、；"を入力すると、それ以降の指定は無視され 
ます。 


例： LIB lang -+heap ; 

この例では、処理の対象となるライブラリファイルは、、 lang . lib 〃です。このライ 
ブラリファイルの拡張子は、、丄 IB " なので、これを省略して指定しています。 

ライブラリに加える編集（コマンド）は、、、- + heap 〃で、ライブラリ中のモジュー 
ル、、 heap " を新しいモジュールに交換します 0 このコマンドに従って、ライブラリ 
中のモジュール、、 heap " をオブジヱクトファイル、、 heap . obj " の内容と置き換えま 
す。 

コマンド ライ ンの 最後にセ ミコロン （ ； ） が ついてい るので、これよりも後ろの 
パラメータに 関しては、初期設定に従った処理が行われます。このため、リスト 
ファイルは生成されず、編集はライブラリファイルに直接反映され、新しいライ 
ブラリ（出カファイル）は作成されません0 


例： LIB lang -+heap ， lang.lst, langl.lib 

この例は、前例と同様に、ライブラリ、ヽ lang . lib 〃のモジユール、、 heap 〃を置き換え 
るものですが、リストファイル名と出カファイル名が指定されています。このた 
め、クロスリファレンスリストファイル、 Mang . lst " を作成します。また、編集結果 
は、出カファイル、、 langl . lib 〃に収められ、編集の元になったライブラリ、、 lang . lib " 
は、元の状態のまま残されます。 

■ LIB のプロンプトでの指定方法 

コマンドラインで、、 LIB 〃だけを入力すると、処理に必要な情報の入力を求める 
コマンドプロンプトを表示します。コマンドプロンプトによる入力方法はつぎの 


とおりです。 


1. LIB とタイブし、リターンキーを押すと、つぎのようなプロンプトが表示さ 
れます。 

Library name : 

2. ここで作成•編集したい、ライブラリファイル名をタイプします。ライブラリ 
ファイル名の拡張子が、、丄 IB 〃のときは、これを省略することができます。 
ファイル名をタイプしたら、リターンキーを押します。指定したファイルを 
検索して見つからない場合は、つぎのようなプロンプトを表示します。 


Library file does not exist. Creater 
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ここで、、 Yes " を入力すると、新しいライブラリファイルが作成されます。 
\、 No " を入力すると、 MS - DOS に戻ります。 

3. ライブラリフアイル名の入力が済むと、 LIB は、ライブラリに行う編集処理 
(オペレーション）の指示を求める第2のプロンプトを表示します。 

Operations : 


ライブラリに行う編集操作（コマンド）をタイプして、リターンキーを押しま 
す。指示するコマンドが多く、1行で入りきらないときは、その行の最後にア 
ンパサンド記号 （&) をタイプして、リターンキーを押します。 LIB は、同じコ 
マンドプロンプトを次の行に表示するので、コマンドの続きをタイプします。 
すべてのコマンドをタイプしたら、リターンキーを押します。ライブラリ ファ 
イルの整合性 (5.2 節中の「ライブラリの整合性のチヱック」を参照）をチヱッ 
クするときは、リターンキーだけを押してください。 

4. つぎに、 LIB は、リストファイル名の入力を求める、第 3 のコマンドプロン 
ブトを表示します。 


List file : 

クロス リファレンスリストファイルの名前をタイプし、リターンキーを押し 
ます 0 クロス リファレンスリストファイル名は、ユーザーが自由につけるこ 
とができます。ファイル名の拡張子を自動的につけることはしません。 クロ 
スリファレンスリストファイルが不必要なときは、何もタイプせずに、リタ ー 
ンキーを押してください。ライブラリファイルを新規に作成する場合、表示 
される コマンド プロンプトはここまでで、 LIB はライブラリの作成 •編集 処 
理を開始します。 

5. すでにあるライブラリファイルを編集する場合は、つづいて出カファイル名 
の入力を求める、最後のプロンプトが表示されます。 

Output library : 


ライブラリに編集を行った結果（出力）を収める、新しいライブラリファイル 
名（出カファイル名）を入力します。ファイル名拡張子を省略すると、 LIB は、 
自動的に' LIB" という拡張子をつけます。 

出カファイル名を指定せずにリターンキーだけを押すと、指定したライブラ 
リファイルを編集しますが、この場合は編集の元になったライブラリファイ 
ルの拡張子が、、. BAK 〃 につけかえられます。 

出カファイル名をタイプしたら、リターンキーを押してください。 LIB は、 
ライブラリの作成•編集処理を開始します。 
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5.2 UB の起動と使い方 


第2のコマンドプロンプト以降の入力で、セミコロン （ ： ） を入力すると、それ 
以後の処理が、 LIB の初期設定に従って行われます。 LIB は、セミコロンが入力 
されると、それ以後のコマンドプロンプトの表示をせずに、ライブラリの編集を 
開始します。 


処理に関係したファイルが、カレントディレクトリ以外にあるときは、ドライ 
ブ名、パス名を含めた正しいファイル名を指定してください。 

ライブラリファイルのページサイズを指定することができます。この指定は、 
ライブラリファイル名の指定と共に行います。詳しくは、 5.2 節中の「ライブラリ 
ページサイズの設定」を参照してください。 

例： LIB の表示するコマンドプロンプトに沿った、入力例をつぎに示しま 

す0 


Library File : math 
Operations ■ +sin+cos+atan & 

Operations : +exp 
List file : 

Output library : mathl 

この例では、ライブラリファイル、、 MATH 丄 IB" が処理の対象になっていま 
す。くコマンド〉では、4つのオブジェクトモジュール （sin、cos、atan、exp) の追 
加が指定されています0各モジュールは、 SIN.OBJ、COS.OBJ、ATAN.OBJ、 
EXP.OBJ というファイルに収められています〇2行目のコマンドプロンプトの最 
後にタイプしてあるアンパサンド記号 （&) によって、指定したいコマンドの続き 
を入力することができます。 ''List file :〃プロンプトに対しては何もタイプせず 
にリターンキーを押しているので、クロスリファレンスリストファイルは作成さ 
れません。ライブラリ、、 MATH 丄 IB 〃に4つのオブジェクトモジュールを追加し 
た結果(新しいライブラリ）は、 、、MATH1 丄 IB〃 という名前のファイルに収められ 
ます。編集の元になったライブラリ vv MATH.LIB /, は、そのままの内容で保存され 
ます。 
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■ 応答ファイルでの指定方法 

ファイル名やコマンドなど、 LIB に対する入力だけを収めた、、応答ファイル"を 
用意しておき、この応答ファイルの内容に従って処理を進める方法です。このと 
きはつぎのように、"をつけて入力します。 

LIB @<応答ファイル名> 

アットマーク（@)は、後ろにつづくファイル名が（ライブラリファイル名ではな 
く ） 応答ファイルであることを表します。また、応答ファイルがカレントディレク 
トリ以外にあるときは、ドライブ名、パス名を含めて指定できます。 

応答ファイルの名前は、自由につけることができます。このファイルの内容は、 
つぎのような形で記述します。 


<ライブラリファイル名 >[/PAGESIZE : n ] 

<コマンド> 

<クロスリファレンスリストファイル名> 

<出カファイル名> 

応答ファイル内の各行は、前項で解説したプロンプトの入力に対応していま 
す。くコマンド〉が多く、1行に収まらないときは、その行の最後にアンパサンド 
記号 （&) をつけて、次の行に継続することができます。パラメータを指定しない場 
合は、その行を空にしておきます。 

応答ファイルを利用する方法で起動すると、コマンドプロンプトとそれに対応 
する応答ファイルの内容を表示しながら処理を進めます。応答ファイルの内容が 
不足しているときは、該当するコマンドプロンプトを表示し、ユーザーの入力を 
待って処理を再開します。 

応答ファイル中でも、 LIB の初期設定に従った処理を指示する、セミコロン 
(;) を利用することができます。 


例： PUB 

+cursor-4-heap * stack 
cross.1st 

この例のような内容を持つ応答ファイルでは、処理されるライブラリファイル 
名は、' PLIB 丄 IB " です 0 コマンドは、モジュール、、 cursor " の追加、 、、 heap " の置き換 
え、 xx stack " のコピーが指示されています。また、クロスリフ ァレンス リストファ 
イル、、 cross . lst 〃が、作成されます。 
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5.2 LIB の起動と使い方 


■ ライブラリの整合性のチェック 

ライブラリファイル名だけを指定して、コマンドを指定しないと、 LIB は、ラ 
イブラリの整合性をチェックします。 

LIB は、指定されたライブラリ中のすべてのモジュールがアクセスできるかど 
うか調べます。調べたライブラリ中になんらかの問題があった場合は、ェラーメッ 
セージを表示します。問題がなかったときは、特にメッセージは出力されず、 MS 
-DOS のプロンブトが表示されます。 

整合性のチェックは、ライブラリ見出しテーブルと実際の内容に差がないこと 
を確かめるときなどに行います。たとえば、ライブラリファイルを他のディスク 
から コピーした 後など、この整合性のチェックを行って、 コピーが 正確に行われ 
たか否かを確認するとよいでしょう。 

なお、モジュールを追するときは、事前に整合性のチェックを行うので、モ 
ジュールを追加する度に整合性チェックを行う必要はありません。 


例： LIB math ; 

この例は、ライブラリファイル、、 MATH 丄 IB 〃のチエックを行うものです。 

■ ライブラリページサイズの設定 

ユーザーは ライブラリ の ページサイズを設定することができます。ページサイ 
ズの設定は、編集•作成するライブラリファイル名の指定と共に行います。指定す 
るときは、/ PAGESAIZE スイツチを使って、つぎのように記述します。 



/PAGESIZE : < n > 


ここで、 < n > は希望するページサイズで、16〜32768の間の2のべき乗数を指 
定することができます。 

ページサイズの設定は、ライブラリ中のモジュールの配置 ffi 列）を制御するも 
のです。モジュールは、常に、ページサイズ（バイト単位）の倍数の位置からスター 
卜されるように配置されます。ライブラリを新規に作成するときの LIB の初期設 
定は、16(バイト）となっています。 

ページサイズは、 LIB の採用しているインデックス技法と関連しています。こ 
の方法では、ページサイズは大きいほど、ライブラリに多くのモジュールを登録 
することができます。しかし、ライブラリ中の各モジュールは、平均 n /2 バイト 
( n はページサイズ）の無駄なスペースを含んでいます。したがって、実用上は小さ 
なページサイズの方が有益なことが多く、できるかぎり小さなページサイズを指 
定した方がよいでしょう。 

例： LIB math/PAGESAIZE : 256 
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この例は、ライブラリ、、 MATH 丄 IB ’， のページサイズを256(バイト）に設定した 
ものです。 


■ クロスリファレンスリストの生成 

クロスリファレンスリストファイル名を指定すると、クロスリファレンスリス 
卜を得ることができます。このクロスリファレンスリストには、2種類のリストが 
収められます。1つはライブラリ中のすべてのパブリックシンボルのリストで、も 
う1つはライブラリ中のすべてのモジュールのリストです。 

パブリックシンボルのリストには、すべてのシンボルがアルファべット順に収 
められます0各シンボルは、それを参照しているモジュール名の後に表示されま 
す。 

例： EXIT …… error 

STARTmain 

SUM.add 

SUM2add 

モジュールのリストには、すべてのモジュールがアルファベット順に収められ 
ます。モジュール名は、そのモジュール中で参照されるアルファベット順のパブ 
リツクシンボルの後ろに表示されます。 


例： 


error Oftset : 
EXIT 

main Offset : 

START 

add Offset : 

SUM 


0000060 OH Code and data size 

0000020 OH Code and data size 

0000040 OH Code and data size 

SUM2 


CH 

20H 

20H 
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5.3 し旧のコマンド 


5.3 UB のコマンド 

くコマンド〉の指示に用いる、 LIB のコマンドにはつぎのようなものがあります。モジユールの追カロ • 
削除•置換はライブラリの編集に用い、コピー•移動は新しいライブラリの作成に関係したコマンドです。 


機 能 

コマンド 

モジュールの追加 
ライブラリの連結 

卜 

モジュ 1 ー ルの削除 

— 

モジュールの置換 

一十 

モジュールのコピー 

ホ 

モジュールの移動 

- * 


これらのコマンドは、処理の対象となるオブジェクトフアイル名•オブジェクトモジュール名の先頭に 
つけて使用します。 


■ モジュールの追加 



+<ォブジェクトファイル名> 


— 


追カロ （+) コマンドは、オブジェクトモジュールをライブラリに登録するときに 
使います。くオブジェクトファイル名〉は、追加！したいモジュールを収めたファイ 
ル名です。このファイルの拡張子が' OBJ 〃のときは、これを省略することができ 
ます0ファイルがカレントディレクトリ以外に存在しているときは、ドライブ名 
やパス名などを含めて指定してください。追加コマンドを示す記号 （+) と、オブ 
ジェクトファイル名の間には、スペース（空白）を入れないでください。モジュー 
ルは、常にライブラリファイルの後ろへ追加されます。 




LIB math +sin_obj 


この例は、オブジェクトフアイル、' sin . obj 〃中のモジュールをライブラリ 、、 math . 
lib " に追加するものです。 


LIB ¥lib¥math +cos, list ; 

この例は、 ¥ lib ディレクトリのライブラリ v 、 math . lib 〃へ、オブジェクトファイ 
ル、、 cos . obj " 中のモジュールを追加するものです 0 さらに、クロスリファレンスリ 
ストフアイル、、 list " の作成を指定しています。 
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LIB math +A : ¥src¥atan ； 


この例は、カレントデイレクトリのライブラリ、、 math . lib "へ、ドライブ A :のサ 
ブデイレクトリ、、 sr どのオブジェクトフアイル、、 atan . obj " 中のモジュールを追加 
するものです。 


■ モジュールの削除 



-< モジュール名> 


削除コマンド （-) は、< モジュール名 > で指定されたオブジェクトモジュールを 
指定されたライブラリファイルから削除します。くモジュール名 > は、ライブラリ 
見出しテーブルに登録されている名前で、正確に指定してください。 

なお、 LIB はコマンドライン上の順番に関係なく、モジュールの追加に先立っ 
て、削除を行います。したがって、モジュールの更新(新バージョンへの変更）は、 
確実に行われます。 


サンプル 


LIB math -sin 


この例は、ライブラリファイル、、 math . lib 〃の、モジュール、、 sin 〃を削除するもの 
です。 


LIB ¥lib¥math -cos, list : 

この例は、サブディレクトリ、 x lib 〃の、ライブラリファイル、、 math . lib 〃から、モ 
ジュール': os " を削除するものです。さらに、編集の終わったライブラリファイル 
の、クロスリファレンスリストファイル、、 list 〃を作成します。 


LIB math +a . ¥src¥atan -atan , 


この例は、ライブラリファイル、、 math . lib 〃の、モジュール、、 atan 〃を削除し、ドラ 
イブ A :のディレクトリ、、 src " にあるオブジェクトファイル、、 atan 〃を追加します 0 
ここでは、同じ名前のモジュールの追加が先に指定されていますが、 LIB は、コ 
マンドライン上で指定される順番に関係なく、削除を先に行います。 
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5.3 UB のコマンド 


■ モジュールの置換 



-+< モジュール名> 


IBHI 


置換コマンド （-+) は、指定されたモジュールをライブラリファイルから削除す 
るとともに、同じ名前のオブジェクトモジュールファイルをライブラリに追加し 
ます0指定するくモジュール名> は、ライブラリ見出しテーブルに登録されてい 
る名前で、正確に指定してください。 

LIB は、まず指定されたオブジェクトモジュールをライブラリから削除しま 
す0次に、カレントディレクトリ中で、削除したくモジュール名〉に拡張子、、. OBJ " 
のついたファイルを捜し、これを追加します。 


サンプル 


LIB math -+cos 

この例は、ライブラリファイル、、 math . lib ’’ の、モジュール、、 cos " を削除し、オブ 
ジェクトモジュールファイル、、 cos . obj " を追加します。 


■ モジュールのコピー 



*< モジュール名> 




コピーコマンド （*) は、指定された名前のモジュールをコピーし、同じ名前の才 
ブジェクトモジュールファイルを作成します〇< モジュール名〉は、ライブラリ見 
出しテーブルに登録されている名前で、正確に指定してください。 

コピーしたモジュールが収められるオブジェクトファイル名は、くモジュール 
名〉と同じ名前で、拡張子、、. OBJT がつけられます。また、このファイルは、カレ 
ントディレクトリに作成されます0 



LIB math * cos ； 


この例は、ライブラリファイル、、 math . lib 〃の、モジユール、' cos 〃 をコピーして、 
オブジェクトモジュールファイル、' cos . obj " を作成します。 
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■ モジュールの移動 


IDIIIIE 31 


-*< モジュール名> 




移動コマンド （_*) コマンドは、指定されたモジュールをライブラリファイルか 
ら抜き取り、オブジェクトモジュールファイルに収めます。くモジュール名〉は、 
ライブラリ見出しテーブルに登録されている名前で、正確に指定してください。 

抜き取ったモジュールが収められるオブジェクトファイル名は、くモジュール 
名> と同じ名前で、拡張子、、 . OBJ 〃がつけられます 0 また、このファイルは、カレ 
ントディレクトリに作成されます。また、オブジェクトモジュールファイルに移 
されたモジュールは、ライブラリから削除されます。 


サンプル 


LIB math -* cos 


この例は、ライブラリファイル、、 math . lib " の、モジュール、、 cos " を抜き取り、才 
ブジェクトモジュールファイル、、 C 0 S . 0 br に移します。モジュール、、 cos " は、ライブ 
ラリから削除されます。 


■ ライブラリの連結 



+<ライブラリファイル名> 


Bj'liiii 11111 追加コマンド （+) を用いると、纖を指定したライブラリへ、指定したライブラ 

リファイル全体を追加することもできます。追加するくライブラリファイル名〉 
の拡張子が' LIB 〃のときは、これを省略することができます。 

追加されるライブラリは、編集を指定したライブラリの後ろへ、すでにあるモ 
ジユールを変更•削除することなく追加されます。 


なお、 LIB は、 XENIX 方式、インテル方式のライブラリを MS - DOS のライブ 
ラリへ追加することも可能です。 


サンプル I 


UB mathl +math.lib ; 


この例は、編集中のライブラリファイル、、 mathl . lib 〃へ、ライブラリファイル 
\ nath . lib " を追加するものです。 
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5.4 メッセージ 


LIB が表示するメッセージをアルファベット順に解説します。 

Cannot access file 

ファイルにアクセスできませんでした。 

Cannot create extract file : く ファイル名〉 

出カファイルを作成できませんでした。 

Cannot create listing : くファイル名〉 

リストファイルを作成できませんでした0 

Cannot create new library 

新しいライブラリを作成できませんでした。 

Cannot open response file 

応答ファイルをオープンできません。 

Cannot open VM.TMP 

一時ディスクファイル VM . TMP をオープンできません。 

Cannot read from VM 

一時ディスクファイルから読み込むことができません。 

Cannot rename old library 

古いライブラリをリネームできません。 

Cannot reopen library 

ライブラリを再オープンできません。 

Cannot write to VM 

一時ディスクファイルに書き込むことができません。 

Comma or new line expected 

カンマ、または改行記号を入れてください。 

Error writing to cross reference file 

クロスリファレンスファイルにエラーを 記録しました。 
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ヒ rror writing to new library 

新しいライブラリにエラーを言己録しました。 

Incorrect DOS version 

DOS のバージョンが違います。動作可能な DOS のバージョンで起動してください。 

Insufficient memory 

メモリ容量が不足です。 

Insufficient stack space 

スタック領域が不足です。 

Internal failure 

内部エラーです。 


Invalid library 

ライブラリファイルが不正です。 


Invalid format 

ファイルのフォーマツトが不正です。 

Invalid library header 

ライブラリファイ ルのへ ツダが不正です。 

Missing terminator 

ターミネータがありません。 


Module not in library 

モジュールがライブラリ内にありません0 

Module redefinition in file ignored 

モジュールの再定義は、無視されました。 

No more virtual memory 

仮想メモリが不足です。 

Page size too small 

ページサイズが正しくありません。 

Page size too small 

ページサイズが小さすぎます。 
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5.4 メッセージ 


Symbol redefinition in file ignored 

シンボルの再定義は、無視されました。 

Syntax error 

文法エラーです。 

Too many symbols 

シンポルの数が多過ぎます。 

Unexpected EOF on command input 

コマンドの入力が EOF (エンドオブファイルマーク）によって終了してしまいました0 

Unknown switch 

指定したスイッチが不正です。 

Write to extract file failed 

出カファイルへの書き込みに失敗しました。 


厂 


Write to library file railed 

ライブラリファイルへの書き込みに失敗しました。 
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MAKE :ブログラムメインテナ 


6.1 イントロダクシヨン 

プログラムメインテナ： MAKE は、マクロアセンブラや高級言語によるプログラムの開発工程の保 
守•管理を自動的に行うユーティリティです。 MAKE は、ソースファイルの更新に伴なって、それに関 
連するプログラムの更新など必要な処理をすべて自動的に実行します。 

MAKE の機能は、いわゆるバッチ処理とは異なり、さらに高度です。メインテナンスの目的とする 
ファイル（オブジェクトファイル、ライブラリファイル、 クロス リファレンスリストファイルなど）と、 
それの元になる関連ファイル（ソースファイル、 クロス リファレンスファイル、オブジェクトファイルな 
ど）の作成日付を比較し、目的ファイルの日付が新しレゝ場合にだけ、特定の更新に必要な処理を実行しま 
す。さらに MAKE による処理で生じたファイルの作成日付の食い違い（日付の違い）に関する処理も行 
います。 

MAKE はバッチ処理のように、ファイルが1つでも更新されれば、すべてのファイルのアセンブル、 
コンパイル、リンクを行うようなことはしません。 MAKE を使用することによって、多くのソースファ 
イルを持つプログラムや、完成までに多くのステップを必要とするプログラムの作成で、かなりの手間 
と時間が節約できます。 

■ メイクファイ)レ 

MAKE を使用する場合、実行したい作業とその作業に関連するファイル名を 
記述した、、メイクファイル"をあらかじめ作成しておきます。 

MAKE はこのメイクファイルを読み込んで、それにしたがってコンパイル、ア 
センブル、リンクなどの作業を自動的に行います0 

メイクファイルは、テキストエディタを用いて作成します。ファイルはつぎの 
ような形式の、、作業記述〃を1つ以上記述したものです。 

<目的ファイル名>:<関連ファイル名1> <関連ファイル名2> … 

<コマンド> 


<目的ファイル名> 

更新を必要とするファイルの名前を指定します。指定できるのは1つのファイ 
ルだけで複数指定することはできません。必要であればパス名を含めて指定する 
こともできますが、ドライブ名を指定することはできません。 
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< 関連ファイル名 > 

目的ファイルが関連する（作業に必要となる）ファイルの名前です。必要であれ 
ばパス名、ドライブ名を含めて指定してください。コマンドは、 MS-DOS の外部 
コマンドです。関連ファイルは複数指定できますが、このときはスペースで区切 
る必要があります。関連ファイルが 1 行に入りきらない場合、行の終わりに円記 
号 (¥) を入力すれば、次の行に名前を続けることができます。 

< コマンド > 

MS-DOS の外部コマンドで、 TYPE や COPY などの内部コマンドは記述でき 
ません。コマンドは、複数指定することができますが、各々は必ず新しい行から 
始め、先頭にタブかスペースを入れる必要があります。コマンドは、目的ファイ 
ルが存在しないとき、あるいは目的ファイルの作成日付以後に関連ファイルが修 
正された場合にだけ実行されます。また、環境変数、、 PATH 〃に設定された検索パ 
スによって、コマンドは実行されます。 

メイクファイルの中には、このような作業記述をいくつも記述できますが、 1 つ 
記述の最終行と次の記述の間は、 1 行以上空けて区切らなくてはなりません。 

注意 作業記述を書く順番は重要です。 MAKE は記述順に指定された処理を 

行っていくからです。 

例 . startup.obj : startup.asm 

MASM startup,startup : 

print.obj i print.asm 

MASM print,print,print,print 

print.ref : print.crf 

CREF print,print 

print.exe : startup.obj print.obj¥lib¥syscal.lib 

LINK startup+print,print,print/map,¥lib¥syscal ； 

print.sym : print.map 

MAPSYM -I print.map 

この例では、 5 つの目的ファイル作成のための処理が定義されています。各ファ 
イルは、最低 1 つの関連ファイルと 1 つのコマンドを持ちます。作業記述は、目 
的フアイルの作成順序で入力します。 
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6.2 MAKE の動作例 


■ MAKE の起動 

MAKE はつぎのような書式で起動します。 


MAKE <メイクファイル名> 

くメイクファイル名〉は、あらかじめ作成しておいたメイクファイルの名前で 
す。メイクファイル名は自由につけることができますが、通常、開発するブログ 
ラムと同じ名前を付けて、拡張子は付けません。 

MAKE は起動されると、作業記述を順に調べます。指定された目的ファイルの 
日付がその関連ファイルの日付より新しかったり、該当する目的ファイルがな 
かったすると、 MAKE は指定されたコマンドを表示して実行します。そうでない 
場合は、次の作業記述に移ります。 

指定したメイクファイル、または作業記述中の関連ファイルが見つからなかっ 
たときは、 MAKE はつぎのようなメッセージを表示します。 

make : く メイクフアイル名 〉- file not found 


例： make test 


6.2 MAKE の動作例 

つぎのようなメイクファイルを例にとって、 MAKE の動作を解説します。 

test.obj : test.asm 

MASM test,test,test,test 

test.ref : test.crf 

CREF test,test 

test.exe : test.obj¥lib¥math.lib 

LINK test,test,test/map,¥lib¥math 


test.sym : test.map 

MAPSYM -I test.map 

のメイクファイルのファイル名を、、 TEST " とすると、実行するときはつぎのように入力します0 

MAKE test 
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MAKE が行う各ステップの処理をつぎに示します。 

1. 、' test . asm 〃の修正日付と、 X test . exe 〃の日付を比較します o \ est . exe " の日付の方が新しいか、または存 
在しない場合、 MAKE は、つぎのコマンドを実行します。 

MASM test,test,test,test 

それ以外の場合は、 MAKE は、次の作業記述へ進みます。 

2. v 、 test . ref " と'' test.crf 〃の日付を比較します。 、、 test.ref 〃の日付の方が新しい場合、 MAKE はつぎのコ 
マンドを実行します。 

CREF test,test 

3. 、' test.exe 〃と 、、 test . ob ： i 〃、 および、、 test.exe 〃と NV math . lib ,/ との日付を比較します。 4 est . exe " の日付がど 
ちらかのファイルより新しい場合、 MAKE はつぎのコマンドを実行します。 

LINK test,test,test/map,¥lib¥math.lib 

4. x ' test . sym " と ''testmap 〃の日付を比較します。日付が新しい場合は、つぎに示すコマンドを実行しま 
す0 


MAPSYM -I test.map 

、' test.asm 〃が最初に作成されたときは、 MAKE はすべてのコマンドを実行します。これは、メイクファ 
イル中のすべての目的ファイルがないためです。どの関連ファイルも変更しないで MAKE を再度起動 
させると、 MAKE はどのコマンドも実行しません。 

ライブラリファイル \' math.lib 〃を変更してその他の変更を行わなかった場合、 LINK コマンドを実行 
します。これは、、ヽ test.exe 〃の日付が、' math.lib 〃より新しいためです。さらに MAPSYM コマンドも実行 
しますが、これは lestmap 〃が LINK によって作成されるためです。 

MAKE は、このようにファイルの作成日付を判断しながら処理を行いますので、修正されたファイル 
に関する処理のみを行うことができ、処理時間の短縮を図ることが可能となります。 
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6.3 メッセージ 

MAKE が表示するメッセージをアルファべット順に解説します。 

Access denied 

リードオンリーファイルに書き込むことはできません。 

Bad format 

MAKE ファイルのフォーマットが不正です。 

File already exists 

作成すべきファイルと同名のファイルが既に存在しています。 

File not found 

処理の対象となるファイルが見つかりません。 

Invalid data 

MAKE ファイル 内のデータが不正です。 

Invalid drive 

ドライブの指定が不正です。 

Make : unexpected end of file 

MAKE ファイルが完全ではありません。 

Make : out of memory 

メモリ不足です。 

Too many open files 

オープンするファイルの数が多過ぎます。 


1 iE 
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EXE 2 BIN :バイナリファイルコンバータ 


7.1 イントロダクシヨン 

バイナリファイルコンバータ： EXE 2 BIN は、 EXE 形式(拡張子が、、 . EXE ") のプログラムファイルに 
加工を施して、バイナリファイルを作成するためのユーティリティです。 EXE 2 BIN は、一般に EXE 形 
式のファイルからヘッダを取り除いて COM 形式のファイルに変換するのに用いますが、その他にも、 
ROM プログラムなどのような絶対アドレス上に置かれるプログラムを生成するために使用することも 
できます。 


7.2 EXE 2 BIN の起動と使い方 

EXE 2 BIN は、つぎのような書式で起動します。 

EXE 2 BIN くファイル名1> [くファイル名2>] 

<ファイル名1> 

リンカ （ MS - LINK ) で作成されたエラーのない EXE 形式ファイルです。ファイルの常駐部あるいは 
ファイルのコードとデータ部分が 64 K バイト以下でなければなりません。また、スタックセグメントが 
存在してはなりません〇くファイル名1 > の拡張子を省略した場合は、 EXE 形式ファイルと解釈します0 

くファイル名2> 

BIN (バイナリ）形式に変換された結果を格納するファイル名です。くファイル名2> 全体を省略する 
と、<ファイル名1> とおなじファイル名に拡張子'、. BIN " をつけたものとなります〇<ファイル名2>の 
拡張子のみを省略したときは、指定したそのファイル名に拡張子' BIN 〃をつけたものとなります。 

EXE 2 BIN は、処理の対象となる EXE 形式のファイルが持っている条件（プログラムの開始アドレス 
やへッダの内容など）により、つぎに述べるような2種類の変換を行います。 


EXE 21 
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1 . COM 形式ファイルの作成 

EXE 形式のプログラムファイルを COM 形式ファイルに変換する場合、該当するプログラムはつぎの 
ような条件を満たしている必要があります。 

• EXE 形式ファイルのヘッダ部分に、セグメントの設定を要求するリロケート情報がない 
•プログラムの開始アドレスが、 END 疑似命令によって先頭からオフセット 100 H 番地に定義されてい 
る 

• セグメントアドレスを参照する FAR コール/ジャンプがない 
•スタックセグメントがない 

•プログラム全体(常駐部、またはコードとデータ部分)が 64 K バイト以下である 

これらの条件を満たしていれば、そのプログラムはパラグラフ単位でリロケータブルですから、セダ 
メントアドレスを参照している部分をリロケートする必要はなく、したがってヘッダを取り除いても実 
行には影響を与えません。 

EXE 2 BIN でこのようなプログラムを変換すると、 EXE 形式ファイルのへッダ部分だけでなく、プロ 
グラム本体部分の最初の256 (100 H ) バイトも削除します。 

こうして作成されたファイルは、その拡張子、、. BIN 〃を、、. COM " にリネームするだけで、 COM 形式のコ 
マンドファイルとしてそのまま MS - DOS で実行できるようになります。サイズが縮小した分だけディ 
スクからのロードが速くなり、リロケートが不要な分だけ実行開始までの時間を短縮することができま 
す0 


2. BIN 形式ファイルの作成 

COM 形式に変換するための条件を備えていないプログラムの場合、 EXE 2 BIN は単純なバイナリ変 
換を行います。この場合でも、該当する EXE 形式のプログラムファイルはつぎのような条件を満たして 
いる必要があります。 

•プログラムの開始アドレスが、ないか、または先頭番地に定義されている 
•スタックセグメントがない 

•プログラム全体(常駐部、またはコードとデータ部分）が 64 K バイト以下である 

EXE 形式のファイルのヘッダ部分に、セグメントの設定を要求するリロケート情報がなければ、 
EXE 2 BIN はそのフアイルをそのままバイナリ変換します。 

ただし、リロケート情報がある場合、 EXE 2 BIN は、プログラムをロードすべきセグメントアドレスを 
入力するよう要求してきます。 

セグメントを指定してください （16 進）： 

この結果生成されたプログラムは、絶対アドレスに配置されたメモリイメージの形態となります。し 
たがって、プログラムは、ユーザーのアプリケーションプログラムでロードするような場合のみ実行す 
ることができます。コマンドプロセッサ （ COMMAND . COM ) には、このようなプログラムを正しく ロー 
ドする機能はありませんので注意してください。 
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以上2つの条件のどちらにもあてはまらないか、 COM 形式フアイルの条件を満たしてはいるがセグ 
メントの設定がある場合などは、変換できません。この場合、 EXE 2 BIN はエラーメッセージを表示して 
実行を終了します。 


7.3 メッセージ 

EXE 2 BIN が表示するメッセージを解説します。 

DOS のバージョンが違います. 

DOS のバージョンが違います。動作可能な DOS のバージョンで起動してください。 

アクセスは拒否されました. 

リードオンリーファイルに書き込むことはできません。 

警告！. EXE ファイルの読取りエラー 

EXE 形式のファイルの読み込み中に、エラーが発生しました。 

ディスクがいっぱいです. 

ディスク容量に十分な空きがないため、書き込むことができません。 

ファイルが作れません. 

システムファイル、または隠しファイルに書き込みをしようとしました。ファイルの属性を確認して 
ください。 

ファイルが見つかりません. 

指定されたファイルが見つかりません。 

ファイルのサイズが狂っています. 

読み込んだファイルのサイズが、ヘッダ中に記録されているサイズより小さいです。何らかの原因で 
ファイルが不正となっています。 

ファイルは変換できません. 

ファイルをバイナリ変換することはできませんでした。 

メモリが足りません. 

メモリ容量が足らないため、プログラムを正常に実行できません。 


EXE2S 
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索弓 I 


記号 


，，（ダブルクォーテーシヨン） . 36, 48, 88 

$(ドル記号）（シンボル) . 34 

&(アンパサンド記号) ( LIB ). 108, 109,110 

，（シングルクォーテーシヨン） . 36, 88 

• (2 項演算子） . 37 

• (モジュールのコピー： LIB ). 115 

+ (2項演算子） . 37 

+ ( 単項演算子） . 37 

+ ( プラス記号） . 6, 8, 9, 36 

+ ( モジュールの追加： LIB ). 113 

+ ( ライブラリの連結： LIB ). 116 

土（行番号： SYMDEB ). 36 

—(2項演算子） . 37 

—( 単項演算子） . 37 

—( マイナス記号） . 36 

—(ハイフン） . 58, 86 

—(ハイフン）（プロンブト： SYMDEB ). 32 

—( モジュールの削除： LIB ). 114 

—* (モジュールの移動： LIB ). 116 

—+ (モジュールの置換： LIB ). 115 

，（カンマ） . 7,34，106，132 

.(ソース行： SYMDEB ). 36, 91 

• BAK (拡張子） . 108 

• COM (拡張子） . 74,128 

.EXE (拡張子） . 6, 74 

• HEX (拡張子） . 74 

• LIB (拡張子） . 6,106,107,108,116 

• MAP (拡張子） . 6,12,14, 29 

■ OBJ (拡張子） . 6,113,115,116 

.SYM (拡張子） . 29, 31, 66 

/(2項演算子） . 37 


/CPARMAXALLOC (/ C ). 13, 90 

/ DOSSEG (/ DO ). 15 

/ DSALLOCATE (/ DS ). 13 

/ HIGH (/ H ).13 

/ LINENUMBERS (/ LI ).14 

/ MAP (/ M ).12 

/NODEFAULTLIBRARYSEARCH (/ NOD ).14 

/NOGROUPASSOCIATION (/ NOG ).14 

/NOIGNORECASE (/ NOI ).14 

/OVERLAYINTERRUPT (/ O ).15 

/PAGESIZE . 106, 111 

/PAUSE (/ P ).11 

/SEGMENTS (/ SE ).15 

/STACK (/ ST ).12 

: (2 項演算子） .37 

; (セミコロン） . 6, 7, 8, 9, 96,107, 109,110 

0 (山形カツコ：表記法） . 3 

? ( Display 、 式の値の表示： SYMDEB ). 48 

? ( Help 、 コマンドの一覧表示： SYMDEB ) ••…71 

?(疑問符）（シンボル） . 34 

@ (ァツトマーク） （ LIB ). 110 

@ (ァツトマーク） （ LINK ). 9 

@(アツトマーク）（シンボル） . 34 

@<応答ファイル名> ( LIB ). 110 

@ <応答ファイル名〉 ( LINK ). 9 

□(角形カツコ：表記法） . 3 

_(アンダースコア）（シンボル） . 34 

| (縦線：表記法） . 3 

¥(円記号： MAKE ). 122 

•••(繰り返し記号：表記法） . 3 

fCTRp+fcl. 5, 32, 83,105 

( CTRLl+fsl . 32, 83,132 
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索引 


数字 


10進数の表現 ( T ) . 34 

10バイト実数 . 55,64 

16進数の表現 (H). 34 

16進数の和と差の計算 

(H コマンド： SYMDEB) . 72 

1 ラインアセンブル （ A コマンド： SYMDEB) .39 

2進数の表現 (Y). 34 

386 . 94 

486 . 94 

4 バイト（ダブルワード） . 52, 61 

4バイ ト 実数 . 53, 62 

80186 . 39, 94 

80286 . 39, 94 

80287 . 39 

8086 . 39, 94 

8087 . 39 

8088 . 39, 94 

8進数の表現 (0、 Q ) . 34 

8バイ ト 実数 . 54, 63 

□ 

AND(2 項 演算子： SYMDEB). 37 

ASCII 文字 . 49 

Assemble (A コマンド： SYMDEB). 39 


□ 

Break Point (SYMDEB) 

Break Point Set (BP) .41 

Break Point Clear (BC) .42 

Break Point Disable (BD) .43 

Break Point Enable (BE) .44 

Break Point List(BL) .45 

BY (単項演算子： SYMDEB).37 

BYTE.17, 39 

B 

CAPS (表記法) .3 

CODE.15, 20 

COM 形式フアイル . 74,127,128 

Comment(* コマンド： SYMDEB). 46 


common ( 結合タイプ： LINK). 18 

Compare (C コマンド： SYMDEB) .47 

CONST.20 

B 

DATA.18, 20 

Display (? コマンド： SYMDEB).48 

DGROUP.13,15,16 

Dump (SYMDEB) 

Dump(D).56 

Dump Ascii (DA) .49 

Dump Bytes (DB).50 

Dump Doublewords (DD) .52 

Dump Long Reals (DL).54 

Dump Short Reals (DS).53 

Dump Ten-byte Reals (DT).55 

Dump Words (DW).51 

DW (単項演算子： SYMDEB).37 

B 

Enter (SYMDEB) 

Enter (E).65 

Enter Ascii (EA).57 

Enter Bytes (EB).58 

Enter Doublewords (ED) .61 

Enter Long Reals (EL).63 

Enter Short Reals (ES) .62 

Enter Ten-byte Reals (ET) .64 

Enter Words (EW) .60 

Examine Symbol Map 

(X コマンド： SYMDEB) .66 

EXE2BIN ( バイナリファイルコンバータ ）••…127 

EXE2BIN の起動 . 127 

EXE 形式 . 5, 32, 69, 74, 94, 99,127,128 

B 

FCB(File Control Block). 77 

Fill(F コマンド： SYMDEB).68 

m 

Go (G コマンド： SYMDEB).69 
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索引 


Q 

H (16 進数の表現: SYMDEB) . 34 

Help(? コマンド： SYMDEB) .71 

Hex(H コマンド： SYMDEB) .72 

HEX 形式 . 74, 99 



Input (I コマンド： SYMDEB) .73 


□ 

PAGE.17 

PARA.17 

POI (単項 演算子： SYMDEB) .37 

PORT (単項演算子： SYMDEB).37 

private (結合タイプ) .18 

P Trace (P コマンド： SYMDEB).81 

public (結合タイプ） .18 


D 

L (レンジ指定） .35 


□ 

Q (8 進数の表現： SYMDEB) . 34 

Quit(Q コマンド： SYMDEB).82 


LIB (ライブラリマネージャ） . 105 

LIB の起動 . 105 

LINK (リンカ） . 5 
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